<!DOCTYPE html><html lang="zh-Hans"><head><meta charset="utf-8"><title>Angular - AbstractControl</title><meta name="Description" content="Angular is a platform for building mobile and desktop web applications.
    Join the community of millions of developers who build compelling user interfaces with Angular."><base href="/"><meta name="viewport" content="width=device-width,initial-scale=1"><link rel="search" type="application/opensearchdescription+xml" href="assets/opensearch.xml"><link rel="icon" type="image/x-icon" href="assets/images/favicons/favicon.ico"><link rel="icon" type="image/png" href="assets/images/favicons/favicon-32x32.png" sizes="32x32"><link rel="icon" type="image/png" href="assets/images/favicons/favicon-194x194.png" sizes="194x194"><link rel="icon" type="image/png" href="assets/images/favicons/favicon-96x96.png" sizes="96x96"><link rel="icon" type="image/png" href="assets/images/favicons/favicon-16x16.png" sizes="16x16"><link rel="apple-touch-icon" sizes="144x144" href="assets/images/favicons/favicon-144x144.png"><link rel="apple-touch-icon-precomposed" sizes="144x144" href="assets/images/favicons/favicon-144x144.png"><link href="assets/fonts/Material_Icons.css" rel="stylesheet"><link href="assets/fonts/Droid_Sans_Mono.css" rel="stylesheet"><link href="https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css" rel="stylesheet"><link rel="manifest" href="pwa-manifest.json"><meta name="theme-color" content="#1976d2"><meta name="apple-mobile-web-app-capable" content="yes"><meta name="apple-mobile-web-app-status-bar-style" content="translucent"><script async="" src="assets/js/analytics.js"></script><script>!function(e,a,n,t,s,c,g){e.GoogleAnalyticsObject=s,e.ga=e.ga||function(){(e.ga.q=e.ga.q||[]).push(arguments)},e.ga.l=1*new Date,c=a.createElement(n),g=a.getElementsByTagName(n)[0],c.async=1,c.src="assets/js/analytics.js",~e.name.indexOf("NG_DEFER_BOOTSTRAP")||g.parentNode.insertBefore(c,g)}(window,document,"script",0,"ga")</script><script>window.onerror=function(){ga("send","exception",{exDescription:function(e,r,n,a,c){var l;e=e.replace(/^Error: /,""),l=c?c.stack.replace(/^Error: /,"").replace(e+"\n","").replace(/^ +/gm,"").replace(/^at /gm,"").replace(/(?: \(|@)http.+\/([^/)]+)\)?(?:\n|$)/gm,"@$1\n").replace(/ *\(eval code(:\d+:\d+)\)(?:\n|$)/gm,"@???$1\n"):r+":"+(n=n||"?")+":"+(a=a||"?");return(e+"\n"+l).substr(0,150)}.apply(null,arguments),exFatal:!0})}</script><link rel="stylesheet" href="styles.4adbe52ad34df01b5273.css"><style>.cdk-high-contrast-active .mat-toolbar{outline:solid 1px}.mat-toolbar-row,.mat-toolbar-single-row{display:flex;box-sizing:border-box;padding:0 16px;width:100%;flex-direction:row;align-items:center;white-space:nowrap}.mat-toolbar-multiple-rows{display:flex;box-sizing:border-box;flex-direction:column;width:100%}.mat-toolbar-multiple-rows{min-height:64px}.mat-toolbar-row,.mat-toolbar-single-row{height:64px}@media(max-width:599px){.mat-toolbar-multiple-rows{min-height:56px}.mat-toolbar-row,.mat-toolbar-single-row{height:56px}}</style><style>.mat-icon{background-repeat:no-repeat;display:inline-block;fill:currentColor;height:24px;width:24px}.mat-icon.mat-icon-inline{font-size:inherit;height:inherit;line-height:inherit;width:inherit}[dir=rtl] .mat-icon-rtl-mirror{transform:scale(-1,1)}.mat-form-field:not(.mat-form-field-appearance-legacy) .mat-form-field-prefix .mat-icon,.mat-form-field:not(.mat-form-field-appearance-legacy) .mat-form-field-suffix .mat-icon{display:block}.mat-form-field:not(.mat-form-field-appearance-legacy) .mat-form-field-prefix .mat-icon-button .mat-icon,.mat-form-field:not(.mat-form-field-appearance-legacy) .mat-form-field-suffix .mat-icon-button .mat-icon{margin:auto}</style><style>.mat-button .mat-button-focus-overlay,.mat-icon-button .mat-button-focus-overlay{opacity:0}.mat-button:hover .mat-button-focus-overlay,.mat-stroked-button:hover .mat-button-focus-overlay{opacity:.04}@media(hover:none){.mat-button:hover .mat-button-focus-overlay,.mat-stroked-button:hover .mat-button-focus-overlay{opacity:0}}.mat-button,.mat-flat-button,.mat-icon-button,.mat-stroked-button{box-sizing:border-box;position:relative;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;cursor:pointer;outline:0;border:none;-webkit-tap-highlight-color:transparent;display:inline-block;white-space:nowrap;text-decoration:none;vertical-align:baseline;text-align:center;margin:0;min-width:64px;line-height:36px;padding:0 16px;border-radius:4px;overflow:visible}.mat-button::-moz-focus-inner,.mat-flat-button::-moz-focus-inner,.mat-icon-button::-moz-focus-inner,.mat-stroked-button::-moz-focus-inner{border:0}.mat-button[disabled],.mat-flat-button[disabled],.mat-icon-button[disabled],.mat-stroked-button[disabled]{cursor:default}.mat-button.cdk-keyboard-focused .mat-button-focus-overlay,.mat-button.cdk-program-focused .mat-button-focus-overlay,.mat-flat-button.cdk-keyboard-focused .mat-button-focus-overlay,.mat-flat-button.cdk-program-focused .mat-button-focus-overlay,.mat-icon-button.cdk-keyboard-focused .mat-button-focus-overlay,.mat-icon-button.cdk-program-focused .mat-button-focus-overlay,.mat-stroked-button.cdk-keyboard-focused .mat-button-focus-overlay,.mat-stroked-button.cdk-program-focused .mat-button-focus-overlay{opacity:.12}.mat-button::-moz-focus-inner,.mat-flat-button::-moz-focus-inner,.mat-icon-button::-moz-focus-inner,.mat-stroked-button::-moz-focus-inner{border:0}.mat-raised-button{box-sizing:border-box;position:relative;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;cursor:pointer;outline:0;border:none;-webkit-tap-highlight-color:transparent;display:inline-block;white-space:nowrap;text-decoration:none;vertical-align:baseline;text-align:center;margin:0;min-width:64px;line-height:36px;padding:0 16px;border-radius:4px;overflow:visible;transform:translate3d(0,0,0);transition:background .4s cubic-bezier(.25,.8,.25,1),box-shadow 280ms cubic-bezier(.4,0,.2,1)}.mat-raised-button::-moz-focus-inner{border:0}.mat-raised-button[disabled]{cursor:default}.mat-raised-button.cdk-keyboard-focused .mat-button-focus-overlay,.mat-raised-button.cdk-program-focused .mat-button-focus-overlay{opacity:.12}.mat-raised-button::-moz-focus-inner{border:0}._mat-animation-noopable.mat-raised-button{transition:none;animation:none}.mat-stroked-button{border:1px solid currentColor;padding:0 15px;line-height:34px}.mat-stroked-button .mat-button-focus-overlay,.mat-stroked-button .mat-button-ripple.mat-ripple{top:-1px;left:-1px;right:-1px;bottom:-1px}.mat-fab{box-sizing:border-box;position:relative;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;cursor:pointer;outline:0;border:none;-webkit-tap-highlight-color:transparent;display:inline-block;white-space:nowrap;text-decoration:none;vertical-align:baseline;text-align:center;margin:0;min-width:64px;line-height:36px;padding:0 16px;border-radius:4px;overflow:visible;transform:translate3d(0,0,0);transition:background .4s cubic-bezier(.25,.8,.25,1),box-shadow 280ms cubic-bezier(.4,0,.2,1);min-width:0;border-radius:50%;width:56px;height:56px;padding:0;flex-shrink:0}.mat-fab::-moz-focus-inner{border:0}.mat-fab[disabled]{cursor:default}.mat-fab.cdk-keyboard-focused .mat-button-focus-overlay,.mat-fab.cdk-program-focused .mat-button-focus-overlay{opacity:.12}.mat-fab::-moz-focus-inner{border:0}._mat-animation-noopable.mat-fab{transition:none;animation:none}.mat-fab .mat-button-wrapper{padding:16px 0;display:inline-block;line-height:24px}.mat-mini-fab{box-sizing:border-box;position:relative;-webkit-user-select:none;-moz-user-select:none;-ms-user-select:none;user-select:none;cursor:pointer;outline:0;border:none;-webkit-tap-highlight-color:transparent;display:inline-block;white-space:nowrap;text-decoration:none;vertical-align:baseline;text-align:center;margin:0;min-width:64px;line-height:36px;padding:0 16px;border-radius:4px;overflow:visible;transform:translate3d(0,0,0);transition:background .4s cubic-bezier(.25,.8,.25,1),box-shadow 280ms cubic-bezier(.4,0,.2,1);min-width:0;border-radius:50%;width:40px;height:40px;padding:0;flex-shrink:0}.mat-mini-fab::-moz-focus-inner{border:0}.mat-mini-fab[disabled]{cursor:default}.mat-mini-fab.cdk-keyboard-focused .mat-button-focus-overlay,.mat-mini-fab.cdk-program-focused .mat-button-focus-overlay{opacity:.12}.mat-mini-fab::-moz-focus-inner{border:0}._mat-animation-noopable.mat-mini-fab{transition:none;animation:none}.mat-mini-fab .mat-button-wrapper{padding:8px 0;display:inline-block;line-height:24px}.mat-icon-button{padding:0;min-width:0;width:40px;height:40px;flex-shrink:0;line-height:40px;border-radius:50%}.mat-icon-button .mat-icon,.mat-icon-button i{line-height:24px}.mat-button-focus-overlay,.mat-button-ripple.mat-ripple{top:0;left:0;right:0;bottom:0;position:absolute;pointer-events:none;border-radius:inherit}.mat-button-ripple.mat-ripple:not(:empty){transform:translateZ(0)}.mat-button-focus-overlay{opacity:0;transition:opacity .2s cubic-bezier(.35,0,.25,1),background-color .2s cubic-bezier(.35,0,.25,1)}._mat-animation-noopable .mat-button-focus-overlay{transition:none}.cdk-high-contrast-active .mat-button-focus-overlay{background-color:#fff}.cdk-high-contrast-black-on-white .mat-button-focus-overlay{background-color:#000}.mat-button-ripple-round{border-radius:50%;z-index:1}.mat-button .mat-button-wrapper>*,.mat-fab .mat-button-wrapper>*,.mat-flat-button .mat-button-wrapper>*,.mat-icon-button .mat-button-wrapper>*,.mat-mini-fab .mat-button-wrapper>*,.mat-raised-button .mat-button-wrapper>*,.mat-stroked-button .mat-button-wrapper>*{vertical-align:middle}.mat-form-field:not(.mat-form-field-appearance-legacy) .mat-form-field-prefix .mat-icon-button,.mat-form-field:not(.mat-form-field-appearance-legacy) .mat-form-field-suffix .mat-icon-button{display:block;font-size:inherit;width:2.5em;height:2.5em}.cdk-high-contrast-active .mat-button,.cdk-high-contrast-active .mat-fab,.cdk-high-contrast-active .mat-flat-button,.cdk-high-contrast-active .mat-icon-button,.cdk-high-contrast-active .mat-mini-fab,.cdk-high-contrast-active .mat-raised-button{outline:solid 1px}</style><style>.mat-drawer-container{position:relative;z-index:1;box-sizing:border-box;-webkit-overflow-scrolling:touch;display:block;overflow:hidden}.mat-drawer-container[fullscreen]{top:0;left:0;right:0;bottom:0;position:absolute}.mat-drawer-container[fullscreen].mat-drawer-container-has-open{overflow:hidden}.mat-drawer-container.mat-drawer-container-explicit-backdrop .mat-drawer-side{z-index:3}.mat-drawer-container.ng-animate-disabled .mat-drawer-backdrop,.mat-drawer-container.ng-animate-disabled .mat-drawer-content,.ng-animate-disabled .mat-drawer-container .mat-drawer-backdrop,.ng-animate-disabled .mat-drawer-container .mat-drawer-content{transition:none}.mat-drawer-backdrop{top:0;left:0;right:0;bottom:0;position:absolute;display:block;z-index:3;visibility:hidden}.mat-drawer-backdrop.mat-drawer-shown{visibility:visible}.mat-drawer-transition .mat-drawer-backdrop{transition-duration:.4s;transition-timing-function:cubic-bezier(.25,.8,.25,1);transition-property:background-color,visibility}.cdk-high-contrast-active .mat-drawer-backdrop{opacity:.5}.mat-drawer-content{position:relative;z-index:1;display:block;height:100%;overflow:auto}.mat-drawer-transition .mat-drawer-content{transition-duration:.4s;transition-timing-function:cubic-bezier(.25,.8,.25,1);transition-property:transform,margin-left,margin-right}.mat-drawer{position:relative;z-index:4;display:block;position:absolute;top:0;bottom:0;z-index:3;outline:0;box-sizing:border-box;overflow-y:auto;transform:translate3d(-100%,0,0)}.cdk-high-contrast-active .mat-drawer,.cdk-high-contrast-active [dir=rtl] .mat-drawer.mat-drawer-end{border-right:solid 1px currentColor}.cdk-high-contrast-active .mat-drawer.mat-drawer-end,.cdk-high-contrast-active [dir=rtl] .mat-drawer{border-left:solid 1px currentColor;border-right:none}.mat-drawer.mat-drawer-side{z-index:2}.mat-drawer.mat-drawer-end{right:0;transform:translate3d(100%,0,0)}[dir=rtl] .mat-drawer{transform:translate3d(100%,0,0)}[dir=rtl] .mat-drawer.mat-drawer-end{left:0;right:auto;transform:translate3d(-100%,0,0)}.mat-drawer-inner-container{width:100%;height:100%;overflow:auto;-webkit-overflow-scrolling:touch}.mat-sidenav-fixed{position:fixed}</style><style>.nav-link.highlight[_ngcontent-ng-docs-c30]{color:#ff0}</style><style>.mat-progress-bar{display:block;height:4px;overflow:hidden;position:relative;transition:opacity 250ms linear;width:100%}._mat-animation-noopable.mat-progress-bar{transition:none;animation:none}.mat-progress-bar .mat-progress-bar-element,.mat-progress-bar .mat-progress-bar-fill::after{height:100%;position:absolute;width:100%}.mat-progress-bar .mat-progress-bar-background{width:calc(100% + 10px)}.cdk-high-contrast-active .mat-progress-bar .mat-progress-bar-background{display:none}.mat-progress-bar .mat-progress-bar-buffer{transform-origin:top left;transition:transform 250ms ease}.cdk-high-contrast-active .mat-progress-bar .mat-progress-bar-buffer{border-top:solid 5px;opacity:.5}.mat-progress-bar .mat-progress-bar-secondary{display:none}.mat-progress-bar .mat-progress-bar-fill{animation:none;transform-origin:top left;transition:transform 250ms ease}.cdk-high-contrast-active .mat-progress-bar .mat-progress-bar-fill{border-top:solid 4px}.mat-progress-bar .mat-progress-bar-fill::after{animation:none;content:"";display:inline-block;left:0}.mat-progress-bar[dir=rtl],[dir=rtl] .mat-progress-bar{transform:rotateY(180deg)}.mat-progress-bar[mode=query]{transform:rotateZ(180deg)}.mat-progress-bar[mode=query][dir=rtl],[dir=rtl] .mat-progress-bar[mode=query]{transform:rotateZ(180deg) rotateY(180deg)}.mat-progress-bar[mode=indeterminate] .mat-progress-bar-fill,.mat-progress-bar[mode=query] .mat-progress-bar-fill{transition:none}.mat-progress-bar[mode=indeterminate] .mat-progress-bar-primary,.mat-progress-bar[mode=query] .mat-progress-bar-primary{-webkit-backface-visibility:hidden;backface-visibility:hidden;animation:mat-progress-bar-primary-indeterminate-translate 2s infinite linear;left:-145.166611%}.mat-progress-bar[mode=indeterminate] .mat-progress-bar-primary.mat-progress-bar-fill::after,.mat-progress-bar[mode=query] .mat-progress-bar-primary.mat-progress-bar-fill::after{-webkit-backface-visibility:hidden;backface-visibility:hidden;animation:mat-progress-bar-primary-indeterminate-scale 2s infinite linear}.mat-progress-bar[mode=indeterminate] .mat-progress-bar-secondary,.mat-progress-bar[mode=query] .mat-progress-bar-secondary{-webkit-backface-visibility:hidden;backface-visibility:hidden;animation:mat-progress-bar-secondary-indeterminate-translate 2s infinite linear;left:-54.888891%;display:block}.mat-progress-bar[mode=indeterminate] .mat-progress-bar-secondary.mat-progress-bar-fill::after,.mat-progress-bar[mode=query] .mat-progress-bar-secondary.mat-progress-bar-fill::after{-webkit-backface-visibility:hidden;backface-visibility:hidden;animation:mat-progress-bar-secondary-indeterminate-scale 2s infinite linear}.mat-progress-bar[mode=buffer] .mat-progress-bar-background{-webkit-backface-visibility:hidden;backface-visibility:hidden;animation:mat-progress-bar-background-scroll 250ms infinite linear;display:block}.mat-progress-bar._mat-animation-noopable .mat-progress-bar-background,.mat-progress-bar._mat-animation-noopable .mat-progress-bar-buffer,.mat-progress-bar._mat-animation-noopable .mat-progress-bar-fill,.mat-progress-bar._mat-animation-noopable .mat-progress-bar-fill::after,.mat-progress-bar._mat-animation-noopable .mat-progress-bar-primary,.mat-progress-bar._mat-animation-noopable .mat-progress-bar-primary.mat-progress-bar-fill::after,.mat-progress-bar._mat-animation-noopable .mat-progress-bar-secondary,.mat-progress-bar._mat-animation-noopable .mat-progress-bar-secondary.mat-progress-bar-fill::after{animation:none;transition:none}@keyframes mat-progress-bar-primary-indeterminate-translate{0%{transform:translateX(0)}20%{animation-timing-function:cubic-bezier(.5,0,.701732,.495819);transform:translateX(0)}59.15%{animation-timing-function:cubic-bezier(.302435,.381352,.55,.956352);transform:translateX(83.67142%)}100%{transform:translateX(200.611057%)}}@keyframes mat-progress-bar-primary-indeterminate-scale{0%{transform:scaleX(.08)}36.65%{animation-timing-function:cubic-bezier(.334731,.12482,.785844,1);transform:scaleX(.08)}69.15%{animation-timing-function:cubic-bezier(.06,.11,.6,1);transform:scaleX(.661479)}100%{transform:scaleX(.08)}}@keyframes mat-progress-bar-secondary-indeterminate-translate{0%{animation-timing-function:cubic-bezier(.15,0,.515058,.409685);transform:translateX(0)}25%{animation-timing-function:cubic-bezier(.31033,.284058,.8,.733712);transform:translateX(37.651913%)}48.35%{animation-timing-function:cubic-bezier(.4,.627035,.6,.902026);transform:translateX(84.386165%)}100%{transform:translateX(160.277782%)}}@keyframes mat-progress-bar-secondary-indeterminate-scale{0%{animation-timing-function:cubic-bezier(.15,0,.515058,.409685);transform:scaleX(.08)}19.15%{animation-timing-function:cubic-bezier(.31033,.284058,.8,.733712);transform:scaleX(.457104)}44.15%{animation-timing-function:cubic-bezier(.4,.627035,.6,.902026);transform:scaleX(.72796)}100%{transform:scaleX(.08)}}@keyframes mat-progress-bar-background-scroll{to{transform:translateX(-8px)}}</style><script charset="utf-8" src="toc-toc-module-es2015.f8531f591ee147aebcc6.js"></script><script charset="utf-8" src="default~code-code-example-module~code-code-tabs-module-es2015.9efcc76d2979a2e605e0.js"></script><script charset="utf-8" src="code-code-example-module-es2015.fa05e6f700453813d256.js"></script><script charset="utf-8" src="assets-js-prettify-js-es2015.ba856648f2dd2d930a9b.js"></script></head><body><aio-shell ng-version="9.0.0-rc.11" class="aio-notification-hide folder-api mode-stable page-api-forms/AbstractControl sidenav-open view-SideNav"><div id="top-of-page"></div><mat-toolbar color="primary" class="mat-toolbar app-toolbar no-print mat-primary mat-toolbar-multiple-rows"><mat-toolbar-row class="mat-toolbar-row notification-container"><aio-notification notificationid="survey-february-2019" expirationdate="2019-03-01" class="ng-tns-c22-0 ng-trigger ng-trigger-hideAnimation" style="height:0"><span class="content ng-tns-c22-0"><a href="http://bit.ly/angular-survey-2019" target="_blank" class="ng-tns-c22-0"><mat-icon role="img" svgicon="insert_comment" aria-label="Announcement" class="mat-icon notranslate icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M20 2H4c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h14l4 4V4c0-1.1-.9-2-2-2zm-2 12H6v-2h12v2zm0-3H6V9h12v2zm0-3H6V6h12v2z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></mat-icon><span class="message"><b>填写这份《一分钟调查》</b>，帮我们（开发组）做得更好！</span><span class="action-button">去填写</span></a></span><button mat-icon-button="" aria-label="Close" class="close-button ng-tns-c22-0 mat-icon-button mat-button-base"><span class="mat-button-wrapper"><mat-icon role="img" svgicon="close" aria-label="Dismiss notification" class="mat-icon notranslate mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M19 6.41L17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"></path><path d="M0 0h24v24H0z" fill="none"></path></svg></mat-icon></span><div matripple="" class="mat-ripple mat-button-ripple mat-button-ripple-round"></div><div class="mat-button-focus-overlay"></div></button></aio-notification></mat-toolbar-row><mat-toolbar-row class="mat-toolbar-row"><button mat-button="" title="Docs menu" class="hamburger mat-button mat-button-base"><span class="mat-button-wrapper"><mat-icon role="img" svgicon="menu" class="mat-icon notranslate mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M3 18h18v-2H3v2zm0-5h18v-2H3v2zm0-7v2h18V6H3z"></path></svg></mat-icon></span><div matripple="" class="mat-ripple mat-button-ripple"></div><div class="mat-button-focus-overlay"></div></button><a href="/" class="nav-link home"><img src="assets/images/logos/angular/logo-nav@2x.png" width="150" height="40" title="Home" alt="Home" class="ng-star-inserted"></a><aio-top-menu _nghost-ng-docs-c30="" class="ng-star-inserted"><ul _ngcontent-ng-docs-c30="" role="navigation"><li _ngcontent-ng-docs-c30="" class="ng-star-inserted"><a _ngcontent-ng-docs-c30="" class="nav-link" href="features" title="特性"><span _ngcontent-ng-docs-c30="" class="nav-link-inner">特性</span></a></li><li _ngcontent-ng-docs-c30="" class="ng-star-inserted"><a _ngcontent-ng-docs-c30="" class="nav-link" href="docs" title="文档"><span _ngcontent-ng-docs-c30="" class="nav-link-inner">文档</span></a></li><li _ngcontent-ng-docs-c30="" class="ng-star-inserted"><a _ngcontent-ng-docs-c30="" class="nav-link" href="resources" title="资源"><span _ngcontent-ng-docs-c30="" class="nav-link-inner">资源</span></a></li><li _ngcontent-ng-docs-c30="" class="ng-star-inserted"><a _ngcontent-ng-docs-c30="" class="nav-link" href="events" title="会议"><span _ngcontent-ng-docs-c30="" class="nav-link-inner">会议</span></a></li><li _ngcontent-ng-docs-c30="" class="ng-star-inserted"><a _ngcontent-ng-docs-c30="" class="nav-link" href="https://blog.angular.io/" title="博客"><span _ngcontent-ng-docs-c30="" class="nav-link-inner">博客</span></a></li><li _ngcontent-ng-docs-c30="" class="ng-star-inserted"><a _ngcontent-ng-docs-c30="" class="nav-link" href="translations/cn/home" title="关于中文版"><span _ngcontent-ng-docs-c30="" class="nav-link-inner">关于中文版</span></a></li></ul></aio-top-menu><aio-search-box class="search-container"><input type="search" aria-label="search" placeholder="搜索"></aio-search-box><div class="toolbar-external-icons-container"><a href="https://twitter.com/angular" title="Twitter" aria-label="Angular on twitter"><mat-icon role="img" svgicon="logos:twitter" class="mat-icon notranslate mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 50 59" xmlns="http://www.w3.org/2000/svg"><path d="M50,9.3c-1.8,0.8-3.8,1.4-5.9,1.6c2.1-1.3,3.7-3.3,4.5-5.7c-2,1.2-4.2,2-6.5,2.5c-1.9-2-4.5-3.2-7.5-3.2c-5.7,0-10.3,4.6-10.3,10.3c0,0.8,0.1,1.6,0.3,2.3C16.1,16.7,8.5,12.6,3.5,6.4c-0.9,1.5-1.4,3.3-1.4,5.2c0,3.6,1.8,6.7,4.6,8.5C5,20,3.4,19.6,2,18.8c0,0,0,0.1,0,0.1c0,5,3.5,9.1,8.2,10.1c-0.9,0.2-1.8,0.4-2.7,0.4c-0.7,0-1.3-0.1-1.9-0.2c1.3,4.1,5.1,7,9.6,7.1c-3.5,2.8-7.9,4.4-12.7,4.4c-0.8,0-1.6,0-2.4-0.1c4.5,2.9,9.9,4.6,15.7,4.6c18.9,0,29.2-15.6,29.2-29.2c0-0.4,0-0.9,0-1.3C46.9,13.2,48.6,11.4,50,9.3z"></path></svg></mat-icon></a><a href="https://github.com/angular/angular" title="GitHub" aria-label="Angular on github"><mat-icon role="img" svgicon="logos:github" class="mat-icon notranslate mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 51.8 50.4" xmlns="http://www.w3.org/2000/svg"><path d="M25.9,0.2C11.8,0.2,0.3,11.7,0.3,25.8c0,11.3,7.3,20.9,17.5,24.3c1.3,0.2,1.7-0.6,1.7-1.2c0-0.6,0-2.6,0-4.8c-7.1,1.5-8.6-3-8.6-3c-1.2-3-2.8-3.7-2.8-3.7c-2.3-1.6,0.2-1.6,0.2-1.6c2.6,0.2,3.9,2.6,3.9,2.6c2.3,3.9,6,2.8,7.5,2.1c0.2-1.7,0.9-2.8,1.6-3.4c-5.7-0.6-11.7-2.8-11.7-12.7c0-2.8,1-5.1,2.6-6.9c-0.3-0.7-1.1-3.3,0.3-6.8c0,0,2.1-0.7,7,2.6c2-0.6,4.2-0.9,6.4-0.9c2.2,0,4.4,0.3,6.4,0.9c4.9-3.3,7-2.6,7-2.6c1.4,3.5,0.5,6.1,0.3,6.8c1.6,1.8,2.6,4.1,2.6,6.9c0,9.8-6,12-11.7,12.6c0.9,0.8,1.7,2.4,1.7,4.7c0,3.4,0,6.2,0,7c0,0.7,0.5,1.5,1.8,1.2c10.2-3.4,17.5-13,17.5-24.3C51.5,11.7,40.1,0.2,25.9,0.2z"></path></svg></mat-icon></a></div></mat-toolbar-row></mat-toolbar><mat-sidenav-container role="main" class="mat-drawer-container mat-sidenav-container sidenav-container mat-drawer-transition has-floating-toc"><div class="mat-drawer-backdrop ng-star-inserted"></div><div class="cdk-visually-hidden cdk-focus-trap-anchor" aria-hidden="true"></div><mat-sidenav tabindex="-1" class="mat-drawer mat-sidenav sidenav ng-tns-c18-1 ng-trigger ng-trigger-transform mat-drawer-side ng-star-inserted mat-drawer-opened" style="transform:none;visibility:visible"><div class="mat-drawer-inner-container ng-tns-c18-1"><aio-nav-menu class="ng-tns-c18-1"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-1 collapsed ng-star-inserted" style="position:relative" href="docs" title="Angular 文档简介" target="_self"><span>简介</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-1 collapsed ng-star-inserted" title="通过构建第一个 Angular 应用来学习基础知识" aria-pressed="false"><span>快速上手</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-1 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="start" title="介绍 Angular 的组件模型、模板语法和组件通讯" target="_self"><span>你的第一个应用</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="start/routing" title="介绍如何使用浏览器的 URL 在组件之间进行路由" target="_self"><span>路由</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="start/data" title="介绍服务以及如何访问外部数据" target="_self"><span>管理数据</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="start/forms" title="学习如何使用表单从用户那里获取并管理数据" target="_self"><span>表单</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="start/deployment" title="通过你的应用放到 Firebase 或自己的服务器上来把它分享给外界" target="_self"><span>部署</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-1 collapsed ng-star-inserted" style="position:relative" href="guide/setup-local" title="使用 Angular CLI 搭建本地开发环境简介" target="_self"><span>搭建环境</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-1 collapsed ng-star-inserted" title="Angular 的基本原理" aria-pressed="false"><span>基本原理</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-1 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="介绍 Angular 应用中的一些基本概念。" aria-pressed="false"><span>Angular 的基本概念</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/architecture" title="Angular 应用中的基本构造块。" target="_self"><span>基本概念简介</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/architecture-modules" title="关于 Angular 模块（NgModules）。" target="_self"><span>模块简介</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/architecture-components" title="关于组件、模板和视图。" target="_self"><span>组件简介</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/architecture-services" title="关于服务与依赖注入。" target="_self"><span>服务与 DI 简介</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/architecture-next-steps" title="超越基础阶段。" target="_self"><span>后续步骤</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="英雄指南是这里大量 Angular 范例的基础" aria-pressed="false"><span>英雄指南</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="tutorial" title="《英雄指南》教程简介" target="_self"><span>简介</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="tutorial/toh-pt0" title="创建应用的外壳" target="_self"><span>应用的“外壳”</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="tutorial/toh-pt1" title="第一部分：构建一个简单的英雄编辑器" target="_self"><span>1. 英雄编辑器</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="tutorial/toh-pt2" title="第二部分：构建一个主从结构的页面，用于展现英雄列表。" target="_self"><span>2. 显示英雄列表</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="tutorial/toh-pt3" title="第三部分：把主从结构的视图重构成几个独立的组件。" target="_self"><span>3. 创建特性组件</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="tutorial/toh-pt4" title="第四部分：创建一个可复用的服务来管理英雄数据。" target="_self"><span>4. 添加服务</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="tutorial/toh-pt5" title="第五部分：添加 Angular 路由器，并且学习在视图之间导航。" target="_self"><span>5. 添加应用内导航</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="tutorial/toh-pt6" title="第六部分：通过 HTTP 来获取并保存英雄数据。" target="_self"><span>6. 从服务器获取数据</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="通过数据绑定构建动态视图" aria-pressed="false"><span>组件与模板</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/displaying-data" title="属性绑定可以帮助应用把数据显示在界面上" target="_self"><span>显示数据</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/template-syntax" title="学习如何写模板，以便借助数据绑定机制显示数据并响应事件。" target="_self"><span>模板语法</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/user-input" title="用户输入会触发 DOM 事件。Angular 会通过事件绑定来监听那些事件，并把修改后的值传回应用的组件和模型中。" target="_self"><span>用户输入</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/lifecycle-hooks" title="Angular 调用指令和组件的生命周期钩子函数，包括它的创建、变更和销毁时。" target="_self"><span>生命周期钩子</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/component-interaction" title="在不同的指令和组件之间共享信息" target="_self"><span>组件交互</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/component-styles" title="添加专属于某个组件的样式" target="_self"><span>组件样式</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/dynamic-component-loader" title="动态加载组件" target="_self"><span>动态组件</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/elements" title="把组件转换成自定义元素" target="_self"><span>Angular 元素</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/attribute-directives" title="属性型指令把行为添加到现有元素上。" target="_self"><span>属性型指令</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/structural-directives" title="结构型指令可以操纵页面的布局" target="_self"><span>结构型指令</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/pipes" title="管道可以在模板中转换显示的内容。" target="_self"><span>管道</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="Angular 的表单" aria-pressed="false"><span>表单</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/forms-overview" title="表单可以创建集中、高效、引人注目的输入体验。Angular 表单可以协调一组数据绑定控件，跟踪变更，验证输入，并表达错误信息。" target="_self"><span>简介</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/reactive-forms" title="使用 FormBuilder、表单组和表单数组创建响应式表单。" target="_self"><span>响应式表单</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/forms" title="使用指令和 Angular 模板语法创建模板驱动表单。" target="_self"><span>模板驱动表单</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/form-validation" title="验证用户的表单输入" target="_self"><span>表单验证</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/dynamic-form" title="使用 FormGroup 渲染动态表单。" target="_self"><span>动态表单</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="Observable 与 RxJS" aria-pressed="false"><span>Observable 与 RxJS</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/observables" title="" target="_self"><span>可观察对象(Observable)</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/rx-library" title="" target="_self"><span>RxJS 库</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/observables-in-angular" title="" target="_self"><span>Angular 中的可观察对象</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/practical-observable-usage" title="" target="_self"><span>用法实战</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/comparing-observables" title="" target="_self"><span>与其它技术的比较</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="Angular 中的模块" aria-pressed="false"><span>NgModules</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/ngmodules" title="使用 NgModule 让你的应用更高效" target="_self"><span>NgModule 简介</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/ngmodule-vs-jsmodule" title="JavaScript 模块和 NgModule 之间的差异" target="_self"><span>JS 模块 vs NgModule</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/bootstrapping" title="告诉 Angular 如何在根 &quot;AppModule&quot; 中构造和引导应用。" target="_self"><span>应用的根模块</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/frequent-ngmodules" title="介绍最常用的 NgModule" target="_self"><span>常用模块</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/module-types" title="介绍特性模块的几种类型" target="_self"><span>特性模块的分类</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/entry-components" title="关于 Angular 中入口组件的一切" target="_self"><span>入口组件</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/feature-modules" title="创建特性模块，以组织你的代码" target="_self"><span>特性模块</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/providers" title="服务提供商与 NgModule" target="_self"><span>服务提供商</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/singleton-services" title="创建单例服务" target="_self"><span>单例服务</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/lazy-loading-ngmodules" title="惰性加载模块，以提高应用的性能" target="_self"><span>惰性加载的特性模块</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/sharing-ngmodules" title="共享 NgModule 让你的应用现代化。" target="_self"><span>共享 NgModule</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/ngmodule-api" title="理解 NgModule 的那些细节。" target="_self"><span>NgModule API</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/ngmodule-faq" title="回答关于 NgModules 的常见问题。" target="_self"><span>NgModule 常见问题</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="依赖注入：创建并注入各种服务。" aria-pressed="false"><span>依赖注入</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/dependency-injection" title="Angular 的依赖注入系统能够为 Angular 创建的类创建并交付它们所依赖的服务。" target="_self"><span>Angular 依赖注入</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/hierarchical-dependency-injection" title="与组件树平行的注入器树，并支持嵌套的依赖。" target="_self"><span>多级注入器</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/dependency-injection-providers" title="各种提供商类型的更多知识。" target="_self"><span>DI 提供商</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/dependency-injection-in-action" title="依赖注入的使用技巧" target="_self"><span>DI 实战</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/dependency-injection-navtree" title="使用注入器树来查找父组件。" target="_self"><span>浏览组件树</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/http" title="通过 HTTP 协议与远程服务器对话。" target="_self"><span>HttpClient</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/router" title="揭示如何通过 Angular 路由进行基本的屏幕导航。" target="_self"><span>路由与导航</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="Angular 动画系统指南" aria-pressed="false"><span>动画</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/animations" title="Angular 动画的基础技术。" target="_self"><span>简介</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/transition-and-triggers" title="转场与触发器的高级技术。" target="_self"><span>转场与触发器</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/complex-animation-sequences" title="复杂的 Angular 动画序列。" target="_self"><span>复杂序列</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/reusable-animations" title="创建可复用的动画。" target="_self"><span>可复用动画</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/route-animations" title="为路由提供转场动画。" target="_self"><span>路由转场动画</span></a></div></aio-nav-item></div></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-1 collapsed ng-star-inserted" title="把 Angular 用到你的实际工作中的一些技巧" aria-pressed="false"><span>其它技术</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-1 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/security" title="Angular 应用开发中的安全技术。" target="_self"><span>安全</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/i18n" title="把应用模板中的文本翻译成多种语言。" target="_self"><span>国际化（i18n）</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/accessibility" title="设计能被所有用户访问的应用" target="_self"><span>无障碍（a11y）</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="Angular Service Worker: 控制应用资源的缓存。" aria-pressed="false"><span>Service Worker 与 PWA</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/service-worker-intro" title="Angular 对 Service Worker 的实现提升了慢速或不稳定的网络连接下的用户体验。" target="_self"><span>简介</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/service-worker-getting-started" title="在 CLI 项目中启用 Service Worker，并在浏览器中查看效果。" target="_self"><span>快速上手</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/app-shell" title="在 CLI 项目中启用应用外壳。" target="_self"><span>应用外壳</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/service-worker-communications" title="那些能让你和 Angular 的 Service Worker 通讯的服务类。" target="_self"><span>与 Service Worker 通讯</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/service-worker-devops" title="使用 Service Worker 运行应用、管理应用更新、调试以及杀掉正在运行的应用。" target="_self"><span>生产环境下的 Service Worker</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/service-worker-config" title="配置 Service Worker 的缓存行为。" target="_self"><span>Service Worker 配置</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/universal" title="使用 Angular Universal 在服务端渲染 HTML。" target="_self"><span>服务端渲染</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="把 AngularJS 应用增量式的升级到 Angular。" aria-pressed="false"><span>从 AngularJS 升级</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/upgrade" title="把 AngularJS 应用增量式的升级到 Angular。" target="_self"><span>升级步骤</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/upgrade-performance" title="用更灵活的方式把 AngularJS 升级到 Angular。" target="_self"><span>更关注性能的升级方式</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/ajs-quick-reference" title="学习如何把 AngularJS 的概念映射到 Angular 中。" target="_self"><span>AngularJS 与 Angular 的概念对照</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="使用共享库扩展 Angular" aria-pressed="false"><span>开发 Angular 库</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/libraries" title="理解何时以及如何使用和创建库。" target="_self"><span>库概览</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/using-libraries" title="把已发布的库集成进你的应用中。" target="_self"><span>使用已发布的库</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/creating-libraries" title="通过创建、发布和使用你自己的库来扩展 Angular。" target="_self"><span>创建库</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="理解原理图" aria-pressed="false"><span>原理图（Schematic）</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/schematics" title="理解 Angular 如何使用原理图。" target="_self"><span>原理图概览</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/schematics-authoring" title="理解原理图的结构。" target="_self"><span>制作原理图</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/schematics-for-libraries" title="使用原理图来把你的库集成进 Angular CLI 中。" target="_self"><span>库的原理图</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/cli-builder" title="使用构建器定制 Angular CLI。" target="_self"><span>CLI 构建器</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/web-worker" title="在 Angular CLI 中使用 Web Worker。" target="_self"><span>Web Worker</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-1 collapsed ng-star-inserted" title="关于构建、测试和部署的信息" aria-pressed="false"><span>开发工作流</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-1 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="理解 AOT 预先编译器。" aria-pressed="false"><span>AOT 预先编译器</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/aot-compiler" title="学习为何以及如何使用预先编译器。" target="_self"><span>预先编译</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/angular-compiler-options" title="配置 AOT 编译。" target="_self"><span>Angular 编译器选项</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/aot-metadata-errors" title="解决 AOT 编译错误。" target="_self"><span>AOT 元数据错误</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/template-typecheck" title="Angular 中的模板类型检查。" target="_self"><span>模板类型检查</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/build" title="构建应用及为应用启动开发服务器。" target="_self"><span>构建与运行</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/bazel" title="如何配置你的环境，以利用 Bazel 进行构建和测试。" target="_self"><span>使用 Bazel 进行构建</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/testing" title="测试 Angular 应用的技巧与实践。" target="_self"><span>测试</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/deployment" title="了解如何部署 Angular 应用。" target="_self"><span>发布</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-2 collapsed ng-star-inserted" title="与开发环境和工具集成起来" aria-pressed="false"><span>开发工具集成</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-2 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-3 collapsed ng-star-inserted" style="position:relative" href="guide/language-service" title="使用 Angular 语言服务加速开发。" target="_self"><span>语言服务</span></a></div></aio-nav-item></div></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-1 collapsed ng-star-inserted" title="工作空间与项目的结构，及其配置文件。" aria-pressed="false"><span>配置</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-1 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/file-structure" title="Angular 工作区在文件系统中是怎样的。" target="_self"><span>项目文件结构</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/workspace-config" title="&quot;angular.json&quot; 包含供 CLI 命令使用的工作区和项目默认配置。" target="_self"><span>工作区配置</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/npm-packages" title="开发期间和运行期间所需的 npm 包的说明。" target="_self"><span>npm 包</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/typescript-configuration" title="给 Angular 开发者的 TypeScript 配置。" target="_self"><span>TypeScript 配置</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/browser-support" title="浏览器支持与腻子脚本指南。" target="_self"><span>浏览器支持</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-1 collapsed ng-star-inserted" title="Angular 的版本发布实践、更新与升级。" aria-pressed="false"><span>发布信息</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-1 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/updating" title="如何把 Angular 应用和库升级到最新版本。" target="_self"><span>保持最新</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/releases" title="Angular 的版本、发布、支持、弃用策略及实践。" target="_self"><span>发布实践</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/updating-to-version-9" title="支持把你的应用从 8 升级到 9。" target="_self"><span>升级到第 9 版</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/deprecations" title="弃用的 Angular API 和特性汇总。" target="_self"><span>弃用清单</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/ivy" title="关于 Angular Ivy 的编译与渲染管道。" target="_self"><span>Angular Ivy</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-1 collapsed ng-star-inserted" title="Angular 语法、编码、术语汇总。" aria-pressed="false"><span>快捷手册</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-1 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/cheatsheet" title="关于 Angular 常用编码技术的快速指南。" target="_self"><span>速查表</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/styleguide" title="写出 Angular 风格的程序" target="_self"><span>风格指南</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="guide/glossary" title="Angular 中最重要的词汇的简要定义。" target="_self"><span>词汇表</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><button type="button" class="vertical-menu-item heading level-1 collapsed ng-star-inserted" title="Angular CLI 命令参考手册。" aria-pressed="false"><span>CLI 命令</span><mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><div class="heading-children level-1 collapsed"><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli" title="CLI 工具介绍、命令、语法" target="_self"><span>概览</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/usage-analytics-gathering" title="管理员如何从用户那里收集使用情况分析。" target="_self"><span>使用情况分析</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/add" title="ng add." target="_self"><span>ng add</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/analytics" title="ng analytics." target="_self"><span>ng analytics</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/build" title="ng build." target="_self"><span>ng build</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/config" title="ng config." target="_self"><span>ng config</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/deploy" title="ng deploy." target="_self"><span>ng deploy</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/doc" title="ng doc." target="_self"><span>ng doc</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/e2e" title="ng e2e." target="_self"><span>ng e2e</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/generate" title="ng generate." target="_self"><span>ng generate</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/help" title="ng help." target="_self"><span>ng help</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/lint" title="ng lint." target="_self"><span>ng lint</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/new" title="ng new." target="_self"><span>ng new</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/run" title="ng run." target="_self"><span>ng run</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/serve" title="ng serve." target="_self"><span>ng serve</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/test" title="ng test." target="_self"><span>ng test</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/update" title="ng update." target="_self"><span>ng update</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/version" title="ng version." target="_self"><span>ng version</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-2 collapsed ng-star-inserted" style="position:relative" href="cli/xi18n" title="ng xi18n." target="_self"><span>ng xi18n</span></a></div></aio-nav-item></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-1 expanded selected ng-star-inserted" style="position:relative" href="api" title="关于 Angular 中类和值的详细信息。" target="_self"><span>API 参考手册</span></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><div class="mat-divider ng-star-inserted" style="margin:4px 20px;border-top:1px solid #d3d3d3"></div></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-1 collapsed ng-star-inserted" style="position:relative" href="https://github.com/ng-docs/ng-docs.github.io/issues" title="github 上的中文互助问答区" target="_blank"><span>互助问答</span><mat-icon role="img" class="mat-icon notranslate material-icons mat-icon-no-color ng-star-inserted" aria-hidden="true">open_in_new</mat-icon></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-1 collapsed ng-star-inserted" style="position:relative" href="https://material.angular.cn" title="Angular Material 组件库的中文文档" target="_blank"><span>官方 Material 组件库</span><mat-icon role="img" class="mat-icon notranslate material-icons mat-icon-no-color ng-star-inserted" aria-hidden="true">open_in_new</mat-icon></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-1 collapsed ng-star-inserted" style="position:relative" href="https://ng.ant.design/" title="Ant Design 的 Angular 实现，服务于企业级后台产品。" target="_blank"><span>ng-zorro 组件库</span><mat-icon role="img" class="mat-icon notranslate material-icons mat-icon-no-color ng-star-inserted" aria-hidden="true">open_in_new</mat-icon></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-1 collapsed ng-star-inserted" style="position:relative" href="https://ng.mobile.ant.design/" title="Ant Design Mobile 的 Angular 实现，服务于无线产品。" target="_blank"><span>ng-zorro mobile 组件库</span><mat-icon role="img" class="mat-icon notranslate material-icons mat-icon-no-color ng-star-inserted" aria-hidden="true">open_in_new</mat-icon></a></div></aio-nav-item><aio-nav-item class="ng-star-inserted"><div class="ng-star-inserted"><a class="vertical-menu-item level-1 collapsed ng-star-inserted" style="position:relative" href="https://flutter-io.cn/" title="Flutter 中文文档站" target="_blank"><span>友站：Flutter 中文</span><mat-icon role="img" class="mat-icon notranslate material-icons mat-icon-no-color ng-star-inserted" aria-hidden="true">open_in_new</mat-icon></a></div></aio-nav-item></aio-nav-menu><div class="doc-version ng-tns-c18-1"><aio-select><div class="form-select-menu"><button class="form-select-button"><span><strong></strong></span><span>stable (v9.0.0)</span></button></div></aio-select></div></div></mat-sidenav><div class="cdk-visually-hidden cdk-focus-trap-anchor" aria-hidden="true"></div><mat-sidenav-content cdkscrollable="" class="mat-drawer-content mat-sidenav-content ng-star-inserted" style="margin-left:261px"><main role="main" class="sidenav-content" id="api-forms/AbstractControl"><aio-mode-banner></aio-mode-banner><aio-doc-viewer class=""><div style="opacity:1"><article><div class="breadcrumb-container"><div class="breadcrumb"><script type="application/ld+json">{
          "@context": "http://schema.org",
          "@type": "BreadcrumbList",
          "itemListElement": [
            { "@type": "ListItem", "position": 1, "item": { "@id": "https://angular.cn//api", "name": "API" } },
            { "@type": "ListItem", "position": 2, "item": { "@id": "https://angular.cn/api/forms", "name": "@angular/forms" } },
            { "@type": "ListItem", "position": 3, "item": { "@id": "https://angular.cn/api/forms/AbstractControl", "name": "AbstractControl" } }
          ]
        }</script><a href="/api">API</a> &gt; <a href="api/forms">@angular/forms</a></div><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L141-L1171" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L141-L1171" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div><header class="api-header"><h1 id="abstractcontrol">AbstractControl<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#abstractcontrol"><i class="material-icons">link</i></a></h1><label class="api-type-label class">class</label></header><aio-toc class="embedded" ng-version="9.0.0-rc.11"><div class="toc-inner no-print collapsed ng-star-inserted"><button type="button" title="Expand/collapse contents" aria-label="Expand/collapse contents" class="toc-heading embedded secondary ng-star-inserted" aria-pressed="false">目录<mat-icon role="img" svgicon="keyboard_arrow_right" class="mat-icon notranslate rotating-icon collapsed mat-icon-no-color" aria-hidden="true"><svg focusable="false" viewBox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"><path d="M8.59 16.34l4.58-4.59-4.58-4.59L10 5.75l6 6-6 6z"></path></svg></mat-icon></button><ul class="toc-list embedded"><li class="h2 ng-star-inserted" title="子类"><a href="api/forms/AbstractControl#子类">子类</a></li><li class="h2 ng-star-inserted" title="参见"><a href="api/forms/AbstractControl#see-also">参见</a></li><li class="h2 ng-star-inserted" title="说明"><a href="api/forms/AbstractControl#description">说明</a></li><li class="h2 secondary ng-star-inserted" title="构造函数"><a href="api/forms/AbstractControl#constructor">构造函数</a></li><li class="h2 secondary ng-star-inserted" title="属性"><a href="api/forms/AbstractControl#属性">属性</a></li><li class="h2 secondary ng-star-inserted" title="方法"><a href="api/forms/AbstractControl#方法">方法</a></li><li class="h3 secondary ng-star-inserted" title="setValidators()"><a href="api/forms/AbstractControl#setvalidators">setValidators()</a></li><li class="h3 secondary ng-star-inserted" title="setAsyncValidators()"><a href="api/forms/AbstractControl#setasyncvalidators">setAsyncValidators()</a></li><li class="h3 secondary ng-star-inserted" title="clearValidators()"><a href="api/forms/AbstractControl#clearvalidators">clearValidators()</a></li><li class="h3 secondary ng-star-inserted" title="clearAsyncValidators()"><a href="api/forms/AbstractControl#clearasyncvalidators">clearAsyncValidators()</a></li><li class="h3 secondary ng-star-inserted" title="markAsTouched()"><a href="api/forms/AbstractControl#markastouched">markAsTouched()</a></li><li class="h3 secondary ng-star-inserted" title="markAllAsTouched()"><a href="api/forms/AbstractControl#markallastouched">markAllAsTouched()</a></li><li class="h3 secondary ng-star-inserted" title="markAsUntouched()"><a href="api/forms/AbstractControl#markasuntouched">markAsUntouched()</a></li><li class="h3 secondary ng-star-inserted" title="markAsDirty()"><a href="api/forms/AbstractControl#markasdirty">markAsDirty()</a></li><li class="h3 secondary ng-star-inserted" title="markAsPristine()"><a href="api/forms/AbstractControl#markaspristine">markAsPristine()</a></li><li class="h3 secondary ng-star-inserted" title="markAsPending()"><a href="api/forms/AbstractControl#markaspending">markAsPending()</a></li><li class="h3 secondary ng-star-inserted" title="disable()"><a href="api/forms/AbstractControl#disable">disable()</a></li><li class="h3 secondary ng-star-inserted" title="enable()"><a href="api/forms/AbstractControl#enable">enable()</a></li><li class="h3 secondary ng-star-inserted" title="setParent()"><a href="api/forms/AbstractControl#setparent">setParent()</a></li><li class="h3 secondary ng-star-inserted" title="setValue()"><a href="api/forms/AbstractControl#setvalue">setValue()</a></li><li class="h3 secondary ng-star-inserted" title="patchValue()"><a href="api/forms/AbstractControl#patchvalue">patchValue()</a></li><li class="h3 secondary ng-star-inserted" title="reset()"><a href="api/forms/AbstractControl#reset">reset()</a></li><li class="h3 secondary ng-star-inserted" title="updateValueAndValidity()"><a href="api/forms/AbstractControl#updatevalueandvalidity">updateValueAndValidity()</a></li><li class="h3 secondary ng-star-inserted" title="setErrors()"><a href="api/forms/AbstractControl#seterrors">setErrors()</a></li><li class="h3 secondary ng-star-inserted" title="get()"><a href="api/forms/AbstractControl#get">get()</a></li><li class="h3 secondary ng-star-inserted" title="getError()"><a href="api/forms/AbstractControl#geterror">getError()</a></li><li class="h3 secondary ng-star-inserted" title="hasError()"><a href="api/forms/AbstractControl#haserror">hasError()</a></li></ul><button type="button" title="Expand/collapse contents" aria-label="Expand/collapse contents" class="toc-more-items embedded material-icons collapsed ng-star-inserted" aria-pressed="false"></button></div></aio-toc><div class="api-body"><section class="short-description"><p translation-result="on">这是 <code><a href="api/forms/FormControl" class="code-anchor">FormControl</a></code>、<code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a></code> 和 <code><a href="api/forms/FormArray" class="code-anchor">FormArray</a></code> 的基类。</p><p translation-origin="off">This is the base class for <code><a href="api/forms/FormControl" class="code-anchor">FormControl</a></code>, <code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a></code>, and <code><a href="api/forms/FormArray" class="code-anchor">FormArray</a></code>.</p><p><a href="api/forms/AbstractControl#description">查看"说明"...</a></p></section><section class="class-overview"><code-example language="ts" hidecopy="true" ng-version="9.0.0-rc.11"><div style="display:none">abstract class <a href="api/forms/AbstractControl" class="code-anchor">AbstractControl</a> { <a class="code-anchor" href="api/forms/AbstractControl#constructor()"><span class="member-name">constructor</span>(validator: ValidatorFn, asyncValidator: AsyncValidatorFn)</a> <a class="code-anchor" href="api/forms/AbstractControl#value"><span class="member-name">value</span>: any</a> <a class="code-anchor" href="api/forms/AbstractControl#validator"><span class="member-name">validator</span>: ValidatorFn | null</a> <a class="code-anchor" href="api/forms/AbstractControl#asyncValidator"><span class="member-name">asyncValidator</span>: AsyncValidatorFn | null</a> <a class="code-anchor" href="api/forms/AbstractControl#parent"><span class="member-name">parent</span>: FormGroup | FormArray</a> <a class="code-anchor" href="api/forms/AbstractControl#status"><span class="member-name">status</span>: string</a> <a class="code-anchor" href="api/forms/AbstractControl#valid"><span class="member-name">valid</span>: boolean</a> <a class="code-anchor" href="api/forms/AbstractControl#invalid"><span class="member-name">invalid</span>: boolean</a> <a class="code-anchor" href="api/forms/AbstractControl#pending"><span class="member-name">pending</span>: boolean</a> <a class="code-anchor" href="api/forms/AbstractControl#disabled"><span class="member-name">disabled</span>: boolean</a> <a class="code-anchor" href="api/forms/AbstractControl#enabled"><span class="member-name">enabled</span>: boolean</a> <a class="code-anchor" href="api/forms/AbstractControl#errors"><span class="member-name">errors</span>: ValidationErrors | null</a> <a class="code-anchor" href="api/forms/AbstractControl#pristine"><span class="member-name">pristine</span>: boolean</a> <a class="code-anchor" href="api/forms/AbstractControl#dirty"><span class="member-name">dirty</span>: boolean</a> <a class="code-anchor" href="api/forms/AbstractControl#touched"><span class="member-name">touched</span>: boolean</a> <a class="code-anchor" href="api/forms/AbstractControl#untouched"><span class="member-name">untouched</span>: boolean</a> <a class="code-anchor" href="api/forms/AbstractControl#valueChanges"><span class="member-name">valueChanges</span>: Observable&lt;any&gt;</a> <a class="code-anchor" href="api/forms/AbstractControl#statusChanges"><span class="member-name">statusChanges</span>: Observable&lt;any&gt;</a> <a class="code-anchor" href="api/forms/AbstractControl#updateOn"><span class="member-name">updateOn</span>: FormHooks</a> <a class="code-anchor" href="api/forms/AbstractControl#root"><span class="member-name">root</span>: AbstractControl</a> <a class="code-anchor" href="api/forms/AbstractControl#setValidators"><span class="member-name">setValidators</span>(newValidator: ValidatorFn | ValidatorFn[]): void</a> <a class="code-anchor" href="api/forms/AbstractControl#setAsyncValidators"><span class="member-name">setAsyncValidators</span>(newValidator: AsyncValidatorFn | AsyncValidatorFn[]): void</a> <a class="code-anchor" href="api/forms/AbstractControl#clearValidators"><span class="member-name">clearValidators</span>(): void</a> <a class="code-anchor" href="api/forms/AbstractControl#clearAsyncValidators"><span class="member-name">clearAsyncValidators</span>(): void</a> <a class="code-anchor" href="api/forms/AbstractControl#markAsTouched"><span class="member-name">markAsTouched</span>(opts: { onlySelf?: boolean; } = {}): void</a> <a class="code-anchor" href="api/forms/AbstractControl#markAllAsTouched"><span class="member-name">markAllAsTouched</span>(): void</a> <a class="code-anchor" href="api/forms/AbstractControl#markAsUntouched"><span class="member-name">markAsUntouched</span>(opts: { onlySelf?: boolean; } = {}): void</a> <a class="code-anchor" href="api/forms/AbstractControl#markAsDirty"><span class="member-name">markAsDirty</span>(opts: { onlySelf?: boolean; } = {}): void</a> <a class="code-anchor" href="api/forms/AbstractControl#markAsPristine"><span class="member-name">markAsPristine</span>(opts: { onlySelf?: boolean; } = {}): void</a> <a class="code-anchor" href="api/forms/AbstractControl#markAsPending"><span class="member-name">markAsPending</span>(opts: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void</a> <a class="code-anchor" href="api/forms/AbstractControl#disable"><span class="member-name">disable</span>(opts: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void</a> <a class="code-anchor" href="api/forms/AbstractControl#enable"><span class="member-name">enable</span>(opts: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void</a> <a class="code-anchor" href="api/forms/AbstractControl#setParent"><span class="member-name">setParent</span>(parent: FormGroup | FormArray): void</a> <a class="code-anchor" href="api/forms/AbstractControl#setValue">abstract <span class="member-name">setValue</span>(value: any, options?: Object): void</a> <a class="code-anchor" href="api/forms/AbstractControl#patchValue">abstract <span class="member-name">patchValue</span>(value: any, options?: Object): void</a> <a class="code-anchor" href="api/forms/AbstractControl#reset">abstract <span class="member-name">reset</span>(value?: any, options?: Object): void</a> <a class="code-anchor" href="api/forms/AbstractControl#updateValueAndValidity"><span class="member-name">updateValueAndValidity</span>(opts: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void</a> <a class="code-anchor" href="api/forms/AbstractControl#setErrors"><span class="member-name">setErrors</span>(errors: ValidationErrors, opts: { emitEvent?: boolean; } = {}): void</a> <a class="code-anchor" href="api/forms/AbstractControl#get"><span class="member-name">get</span>(path: string | (string | number)[]): AbstractControl | null</a> <a class="code-anchor" href="api/forms/AbstractControl#getError"><span class="member-name">getError</span>(errorCode: string, path?: string | (string | number)[]): any</a> <a class="code-anchor" href="api/forms/AbstractControl#hasError"><span class="member-name">hasError</span>(errorCode: string, path?: string | (string | number)[]): boolean</a> }</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="kwd">abstract</span><span class="pln"> </span><span class="kwd">class</span><span class="pln"> </span><a href="api/forms/AbstractControl" class="code-anchor"><span class="typ">AbstractControl</span></a><span class="pln"> </span><span class="pun">{</span><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#constructor()"><span class="member-name"><span class="kwd">constructor</span></span><span class="pun">(</span><span class="pln">validator</span><span class="pun">:</span><span class="pln"> </span><span class="typ">ValidatorFn</span><span class="pun">,</span><span class="pln"> asyncValidator</span><span class="pun">:</span><span class="pln"> </span><span class="typ">AsyncValidatorFn</span><span class="pun">)</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#value"><span class="member-name"><span class="pln">value</span></span><span class="pun">:</span><span class="pln"> any</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#validator"><span class="member-name"><span class="pln">validator</span></span><span class="pun">:</span><span class="pln"> </span><span class="typ">ValidatorFn</span><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><span class="kwd">null</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#asyncValidator"><span class="member-name"><span class="pln">asyncValidator</span></span><span class="pun">:</span><span class="pln"> </span><span class="typ">AsyncValidatorFn</span><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><span class="kwd">null</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#parent"><span class="member-name"><span class="pln">parent</span></span><span class="pun">:</span><span class="pln"> </span><span class="typ">FormGroup</span><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><span class="typ">FormArray</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#status"><span class="member-name"><span class="pln">status</span></span><span class="pun">:</span><span class="pln"> string</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#valid"><span class="member-name"><span class="pln">valid</span></span><span class="pun">:</span><span class="pln"> boolean</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#invalid"><span class="member-name"><span class="pln">invalid</span></span><span class="pun">:</span><span class="pln"> boolean</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#pending"><span class="member-name"><span class="pln">pending</span></span><span class="pun">:</span><span class="pln"> boolean</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#disabled"><span class="member-name"><span class="pln">disabled</span></span><span class="pun">:</span><span class="pln"> boolean</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#enabled"><span class="member-name"><span class="pln">enabled</span></span><span class="pun">:</span><span class="pln"> boolean</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#errors"><span class="member-name"><span class="pln">errors</span></span><span class="pun">:</span><span class="pln"> </span><span class="typ">ValidationErrors</span><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><span class="kwd">null</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#pristine"><span class="member-name"><span class="pln">pristine</span></span><span class="pun">:</span><span class="pln"> boolean</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#dirty"><span class="member-name"><span class="pln">dirty</span></span><span class="pun">:</span><span class="pln"> boolean</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#touched"><span class="member-name"><span class="pln">touched</span></span><span class="pun">:</span><span class="pln"> boolean</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#untouched"><span class="member-name"><span class="pln">untouched</span></span><span class="pun">:</span><span class="pln"> boolean</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#valueChanges"><span class="member-name"><span class="pln">valueChanges</span></span><span class="pun">:</span><span class="pln"> </span><span class="typ">Observable</span><span class="pun">&lt;</span><span class="pln">any</span><span class="pun">&gt;</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#statusChanges"><span class="member-name"><span class="pln">statusChanges</span></span><span class="pun">:</span><span class="pln"> </span><span class="typ">Observable</span><span class="pun">&lt;</span><span class="pln">any</span><span class="pun">&gt;</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#updateOn"><span class="member-name"><span class="pln">updateOn</span></span><span class="pun">:</span><span class="pln"> </span><span class="typ">FormHooks</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#root"><span class="member-name"><span class="pln">root</span></span><span class="pun">:</span><span class="pln"> </span><span class="typ">AbstractControl</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#setValidators"><span class="member-name"><span class="pln">setValidators</span></span><span class="pun">(</span><span class="pln">newValidator</span><span class="pun">:</span><span class="pln"> </span><span class="typ">ValidatorFn</span><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><span class="typ">ValidatorFn</span><span class="pun">[]):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#setAsyncValidators"><span class="member-name"><span class="pln">setAsyncValidators</span></span><span class="pun">(</span><span class="pln">newValidator</span><span class="pun">:</span><span class="pln"> </span><span class="typ">AsyncValidatorFn</span><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><span class="typ">AsyncValidatorFn</span><span class="pun">[]):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#clearValidators"><span class="member-name"><span class="pln">clearValidators</span></span><span class="pun">():</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#clearAsyncValidators"><span class="member-name"><span class="pln">clearAsyncValidators</span></span><span class="pun">():</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#markAsTouched"><span class="member-name"><span class="pln">markAsTouched</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#markAllAsTouched"><span class="member-name"><span class="pln">markAllAsTouched</span></span><span class="pun">():</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#markAsUntouched"><span class="member-name"><span class="pln">markAsUntouched</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#markAsDirty"><span class="member-name"><span class="pln">markAsDirty</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#markAsPristine"><span class="member-name"><span class="pln">markAsPristine</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#markAsPending"><span class="member-name"><span class="pln">markAsPending</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> emitEvent</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#disable"><span class="member-name"><span class="pln">disable</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> emitEvent</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#enable"><span class="member-name"><span class="pln">enable</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> emitEvent</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#setParent"><span class="member-name"><span class="pln">setParent</span></span><span class="pun">(</span><span class="pln">parent</span><span class="pun">:</span><span class="pln"> </span><span class="typ">FormGroup</span><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><span class="typ">FormArray</span><span class="pun">):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#setValue"><span class="kwd">abstract</span><span class="pln"> </span><span class="member-name"><span class="pln">setValue</span></span><span class="pun">(</span><span class="pln">value</span><span class="pun">:</span><span class="pln"> any</span><span class="pun">,</span><span class="pln"> options</span><span class="pun">?:</span><span class="pln"> </span><span class="typ">Object</span><span class="pun">):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#patchValue"><span class="kwd">abstract</span><span class="pln"> </span><span class="member-name"><span class="pln">patchValue</span></span><span class="pun">(</span><span class="pln">value</span><span class="pun">:</span><span class="pln"> any</span><span class="pun">,</span><span class="pln"> options</span><span class="pun">?:</span><span class="pln"> </span><span class="typ">Object</span><span class="pun">):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#reset"><span class="kwd">abstract</span><span class="pln"> </span><span class="member-name"><span class="pln">reset</span></span><span class="pun">(</span><span class="pln">value</span><span class="pun">?:</span><span class="pln"> any</span><span class="pun">,</span><span class="pln"> options</span><span class="pun">?:</span><span class="pln"> </span><span class="typ">Object</span><span class="pun">):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#updateValueAndValidity"><span class="member-name"><span class="pln">updateValueAndValidity</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> emitEvent</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#setErrors"><span class="member-name"><span class="pln">setErrors</span></span><span class="pun">(</span><span class="pln">errors</span><span class="pun">:</span><span class="pln"> </span><span class="typ">ValidationErrors</span><span class="pun">,</span><span class="pln"> opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> emitEvent</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#get"><span class="member-name"><span class="kwd">get</span></span><span class="pun">(</span><span class="pln">path</span><span class="pun">:</span><span class="pln"> string </span><span class="pun">|</span><span class="pln"> </span><span class="pun">(</span><span class="pln">string </span><span class="pun">|</span><span class="pln"> number</span><span class="pun">)[]):</span><span class="pln"> </span><span class="typ">AbstractControl</span><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><span class="kwd">null</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#getError"><span class="member-name"><span class="pln">getError</span></span><span class="pun">(</span><span class="pln">errorCode</span><span class="pun">:</span><span class="pln"> string</span><span class="pun">,</span><span class="pln"> path</span><span class="pun">?:</span><span class="pln"> string </span><span class="pun">|</span><span class="pln"> </span><span class="pun">(</span><span class="pln">string </span><span class="pun">|</span><span class="pln"> number</span><span class="pun">)[]):</span><span class="pln"> any</span></a><span class="pln">
  </span><a class="code-anchor" href="api/forms/AbstractControl#hasError"><span class="member-name"><span class="pln">hasError</span></span><span class="pun">(</span><span class="pln">errorCode</span><span class="pun">:</span><span class="pln"> string</span><span class="pun">,</span><span class="pln"> path</span><span class="pun">?:</span><span class="pln"> string </span><span class="pun">|</span><span class="pln"> </span><span class="pun">(</span><span class="pln">string </span><span class="pun">|</span><span class="pln"> number</span><span class="pun">)[]):</span><span class="pln"> boolean</span></a><span class="pln">
</span><span class="pun">}</span></code>
    </pre></aio-code></code-example><div class="descendants class"><h2 id="子类">子类<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#子类"><i class="material-icons">link</i></a></h2><ul><li> <code><a href="api/forms/FormArray" class="code-anchor">FormArray</a></code> </li><li> <code><a href="api/forms/FormControl" class="code-anchor">FormControl</a></code> </li><li> <code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a></code> </li></ul></div></section><section class="see-also"><h2 id="see-also">参见<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#see-also"><i class="material-icons">link</i></a></h2><ul><li><p translation-result="on"><a href="/guide/forms">表单</a></p><p translation-origin="off"><a href="/guide/forms">Forms Guide</a></p></li><li><p translation-result="on"><a href="/guide/reactive-forms">响应式表单</a></p><p translation-origin="off"><a href="/guide/reactive-forms">Reactive Forms Guide</a></p></li><li><p translation-result="on"><a href="/guide/dynamic-form">动态表单</a></p><p translation-origin="off"><a href="/guide/dynamic-form">Dynamic Forms Guide</a></p></li></ul></section><section class="description"><h2 id="description">说明<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#description"><i class="material-icons">link</i></a></h2><p translation-result="on">它提供了一些所有控件和控件组共有的行为，比如运行验证器、计算状态和重置状态。 它还定义了一些所有子类共享的属性，如 <code>value</code>、<code>valid</code> 和 <code>dirty</code>。不允许直接实例化它。</p><p translation-origin="off">It provides some of the shared behavior that all controls and groups of controls have, like running validators, calculating status, and resetting state. It also defines the properties that are shared between all sub-classes, like <code>value</code>, <code>valid</code>, and <code>dirty</code>. It shouldn't be instantiated directly.</p></section><h2 id="constructor">构造函数<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#constructor"><i class="material-icons">link</i></a></h2><a id="constructor()"></a><table class="is-full-width method-table constructor"><tbody><tr><td class="short-description"><p translation-result="on">初始化这个 AbstractControl 实例。</p><p translation-origin="off">Initialize the AbstractControl instance.</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">constructor</span>(validator: <a href="api/forms/ValidatorFn" class="code-anchor">ValidatorFn</a>, asyncValidator: <a href="api/forms/AsyncValidatorFn" class="code-anchor">AsyncValidatorFn</a>)</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="kwd">constructor</span></span><span class="pun">(</span><span class="pln">validator</span><span class="pun">:</span><span class="pln"> </span><a href="api/forms/ValidatorFn" class="code-anchor"><span class="typ">ValidatorFn</span></a><span class="pun">,</span><span class="pln"> asyncValidator</span><span class="pun">:</span><span class="pln"> </span><a href="api/forms/AsyncValidatorFn" class="code-anchor"><span class="typ">AsyncValidatorFn</span></a><span class="pun">)</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数">参数</h6><table class="is-full-width list-table parameters-table constructor-overload-parameters"><tbody><tr class="constructor-overload-parameter"><td class="param-name"><a id=""></a> <code>validator</code> </td><td class="param-type"><code><a href="api/forms/ValidatorFn" class="code-anchor">ValidatorFn</a></code></td><td class="param-description"><p translation-result="on">用于决定该控件有效性的同步函数。</p><p translation-origin="off">The function that determines the synchronous validity of this control.</p></td></tr><tr class="constructor-overload-parameter"><td class="param-name"><a id=""></a> <code>asyncValidator</code> </td><td class="param-type"><code><a href="api/forms/AsyncValidatorFn" class="code-anchor">AsyncValidatorFn</a></code></td><td class="param-description"><p translation-result="on">用于决定该控件有效性的异步函数。</p><p translation-origin="off">The function that determines the asynchronous validity of this control.</p></td></tr></tbody></table></div></td></tr></tbody></table><section class="instance-properties"><a name="properties"></a><h2 id="属性">属性<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#属性"><i class="material-icons">link</i></a></h2><table class="is-full-width list-table property-table"><thead><tr><th>属性</th><th>说明</th></tr></thead><tbody><tr class="instance-property"><td><a id="value"></a> <code class=""><span class="member-name">value</span>: any</code></td><td><span class="read-only-property">只读</span><p translation-result="on">控件的当前值。</p><p translation-origin="off">The current value of the control.</p><ul><li><p translation-result="on">对于 <code><a href="api/forms/FormControl" class="code-anchor">FormControl</a></code>，它是当前值。</p><p translation-origin="off">For a <code><a href="api/forms/FormControl" class="code-anchor">FormControl</a></code>, the current value.</p></li><li><p translation-result="on">对于启用状态的 <code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a></code>，它是由组中的每个已启用的成员控件的名称和值组成的对象。</p><p translation-origin="off">For an enabled <code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a></code>, the values of enabled controls as an object with a key-value pair for each member of the group.</p></li><li><p translation-result="on">对于禁用状态的 <code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a></code>，它是由组中的所有成员控件的名称和值组成的对象。</p><p translation-origin="off">For a disabled <code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a></code>, the values of all controls as an object with a key-value pair for each member of the group.</p></li><li><p translation-result="on">对于 <code><a href="api/forms/FormArray" class="code-anchor">FormArray</a></code>，它是有所有已启用的控件的值组成的数组。</p><p translation-origin="off">For a <code><a href="api/forms/FormArray" class="code-anchor">FormArray</a></code>, the values of enabled controls as an array.</p></li></ul></td></tr><tr class="instance-property"><td><a id="validator"></a> <code class=""><span class="member-name">validator</span>: <a href="api/forms/ValidatorFn" class="code-anchor">ValidatorFn</a> | null</code></td><td><span class="from-constructor">Declared in constructor.</span><p translation-result="on">用于决定该控件有效性的同步函数。</p><p translation-origin="off">The function that determines the synchronous validity of this control.</p></td></tr><tr class="instance-property"><td><a id="asyncValidator"></a> <code class=""><span class="member-name">asyncValidator</span>: <a href="api/forms/AsyncValidatorFn" class="code-anchor">AsyncValidatorFn</a> | null</code></td><td><span class="from-constructor">Declared in constructor.</span><p translation-result="on">用于决定该控件有效性的异步函数。</p><p translation-origin="off">The function that determines the asynchronous validity of this control.</p></td></tr><tr class="instance-property"><td><a id="parent"></a> <code class=""><span class="member-name">parent</span>: <a href="api/forms/FormGroup" class="code-anchor">FormGroup</a> | <a href="api/forms/FormArray" class="code-anchor">FormArray</a></code></td><td><span class="read-only-property">只读</span><p translation-result="on">父控件。</p><p translation-origin="off">The parent control.</p></td></tr><tr class="instance-property"><td><a id="status"></a> <code class=""><span class="member-name">status</span>: string</code></td><td><span class="read-only-property">只读</span><p translation-result="on">控件的有效性状态。有四个可能的值：</p><p translation-origin="off">The validation status of the control. There are four possible validation status values:</p><ul><li><p translation-result="on"><strong>VALID</strong>: 该控件通过了所有有效性检查。</p><p translation-origin="off"><strong>VALID</strong>: This control has passed all validation checks.</p></li><li><p translation-result="on"><strong>INVALID</strong> 该控件至少有一个有效性检查失败了。</p><p translation-origin="off"><strong>INVALID</strong>: This control has failed at least one validation check.</p></li><li><p translation-result="on"><strong>PENDING</strong>：该控件正在进行有效性检查，处于中间状态。</p><p translation-origin="off"><strong>PENDING</strong>: This control is in the midst of conducting a validation check.</p></li><li><p translation-result="on"><strong>DISABLED</strong>：该控件被禁用，豁免了有效性检查。</p><p translation-origin="off"><strong>DISABLED</strong>: This control is exempt from validation checks.</p></li></ul><p translation-result="on">这些状态值是互斥的，因此一个控件不可能同时处于有效状态和无效状态或无效状态和禁用状态。</p><p translation-origin="off">These status values are mutually exclusive, so a control cannot be both valid AND invalid or invalid AND disabled.</p></td></tr><tr class="instance-property"><td><a id="valid"></a> <code class=""><span class="member-name">valid</span>: boolean</code></td><td><span class="read-only-property">只读</span><p translation-result="on">当控件的 <code>status</code> 为 <code>VALID</code> 时，它就是 <code>valid</code> 的。</p><p translation-origin="off">A control is <code>valid</code> when its <code>status</code> is <code>VALID</code>.</p><p>参见:</p><ul><li><a href="api/forms/AbstractControl#status"><code>status</code></a></li></ul></td></tr><tr class="instance-property"><td><a id="invalid"></a> <code class=""><span class="member-name">invalid</span>: boolean</code></td><td><span class="read-only-property">只读</span><p translation-result="on">当控件的 <code>status</code> 为 <code>INVALID</code> 时，它就是 <code>invalid</code> 的。</p><p translation-origin="off">A control is <code>invalid</code> when its <code>status</code> is <code>INVALID</code>.</p><p>参见:</p><ul><li><a href="api/forms/AbstractControl#status"><code>status</code></a></li></ul></td></tr><tr class="instance-property"><td><a id="pending"></a> <code class=""><span class="member-name">pending</span>: boolean</code></td><td><span class="read-only-property">只读</span><p translation-result="on">当控件的 <code>status</code> 为 <code>PENDING</code> 时，它就是 <code>pending</code> 的。</p><p translation-origin="off">A control is <code>pending</code> when its <code>status</code> is <code>PENDING</code>.</p><p>参见:</p><ul><li><a href="api/forms/AbstractControl#status"><code>status</code></a></li></ul></td></tr><tr class="instance-property"><td><a id="disabled"></a> <code class=""><span class="member-name">disabled</span>: boolean</code></td><td><span class="read-only-property">只读</span><p translation-result="on">当控件的 <code>status</code> 为 <code>DISABLED</code> 时，它就是 <code>disabled</code>。</p><p translation-origin="off">A control is <code>disabled</code> when its <code>status</code> is <code>DISABLED</code>.</p><p translation-result="on">被禁用的控件会豁免有效性检查，并且它的值不会聚合进其祖先控件中。</p><p translation-origin="off">Disabled controls are exempt from validation checks and are not included in the aggregate value of their ancestor controls.</p><p>参见:</p><ul><li><a href="api/forms/AbstractControl#status"><code>status</code></a></li></ul></td></tr><tr class="instance-property"><td><a id="enabled"></a> <code class=""><span class="member-name">enabled</span>: boolean</code></td><td><span class="read-only-property">只读</span><p translation-result="on">如果控件的 <code>status</code> 不是 <code>DISABLED</code> 时，它就是 <code>enabled</code>。</p><p translation-origin="off">A control is <code>enabled</code> as long as its <code>status</code> is not <code>DISABLED</code>.</p><p>参见:</p><ul><li><a href="api/forms/AbstractControl#status"><code>status</code></a></li></ul></td></tr><tr class="instance-property"><td><a id="errors"></a> <code class=""><span class="member-name">errors</span>: <a href="api/forms/ValidationErrors" class="code-anchor">ValidationErrors</a> | null</code></td><td><span class="read-only-property">只读</span><p translation-result="on">一个对象，包含由失败的验证所生成的那些错误，如果没出错则为 null。</p><p translation-origin="off">An object containing any errors generated by failing validation, or null if there are no errors.</p></td></tr><tr class="instance-property"><td><a id="pristine"></a> <code class=""><span class="member-name">pristine</span>: boolean</code></td><td><span class="read-only-property">只读</span><p translation-result="on">如果用户尚未修改 UI 中的值，则该控件是 <code>pristine</code>（原始状态）的。</p><p translation-origin="off">A control is <code>pristine</code> if the user has not yet changed the value in the UI.</p></td></tr><tr class="instance-property"><td><a id="dirty"></a> <code class=""><span class="member-name">dirty</span>: boolean</code></td><td><span class="read-only-property">只读</span><p translation-result="on">如果用户修改过 UI 中的值，则控件是 <code>dirty</code>（脏） 的。</p><p translation-origin="off">A control is <code>dirty</code> if the user has changed the value in the UI.</p></td></tr><tr class="instance-property"><td><a id="touched"></a> <code class=""><span class="member-name">touched</span>: boolean</code></td><td><span class="read-only-property">只读</span><p translation-result="on">如果控件被标记为 <code>touched</code>（碰过） 则为 <code>true</code>。</p><p translation-origin="off">True if the control is marked as <code>touched</code>.</p><p translation-result="on">一旦用户在控件上触发了 <code>blur</code> 事件，则会将其标记为 <code>touched</code>。</p><p translation-origin="off">A control is marked <code>touched</code> once the user has triggered a <code>blur</code> event on it.</p></td></tr><tr class="instance-property"><td><a id="untouched"></a> <code class=""><span class="member-name">untouched</span>: boolean</code></td><td><span class="read-only-property">只读</span><p translation-result="on">如果该控件尚未标记为 <code>touched</code>，则为 <code>true</code>。</p><p translation-origin="off">True if the control has not been marked as touched</p><p translation-result="on">如果用户尚未在控件上触发过 <code>blur</code> 事件，则该控件为 <code>untouched</code>。</p><p translation-origin="off">A control is <code>untouched</code> if the user has not yet triggered a <code>blur</code> event on it.</p></td></tr><tr class="instance-property"><td><a id="valueChanges"></a> <code class=""><span class="member-name">valueChanges</span>: Observable&lt;any&gt;</code></td><td><span class="read-only-property">只读</span><p translation-result="on">一个多播 Observable（可观察对象），每当控件的值发生变化时，它就会发出一个事件 —— 无论是通过 UI 还是通过程序。每当你调用 <code><a href="api/forms/AbstractControl#enable" class="code-anchor">enable()</a></code> 或 <code>disable()</code>，但没有传入 <code>{emitEvent: false}</code> 参数时，它也同样会发出一个事件。</p><p translation-origin="off">A multicasting observable that emits an event every time the value of the control changes, in the UI or programmatically. It also emits an event each time you call enable() or disable() without passing along {emitEvent: false} as a function argument.</p></td></tr><tr class="instance-property"><td><a id="statusChanges"></a> <code class=""><span class="member-name">statusChanges</span>: Observable&lt;any&gt;</code></td><td><span class="read-only-property">只读</span><p translation-result="on">一个多播 Observable（可观察对象），每当控件的验证 <code>status</code> 被重新计算时，就会发出一个事件。</p><p translation-origin="off">A multicasting observable that emits an event every time the validation <code>status</code> of the control recalculates.</p><p>参见:</p><ul><li><a href="api/forms/AbstractControl#status"><code>status</code></a></li></ul></td></tr><tr class="instance-property"><td><a id="updateOn"></a> <code class=""><span class="member-name">updateOn</span>: FormHooks</code></td><td><span class="read-only-property">只读</span><p translation-result="on">报告这个 <code><a href="api/forms/AbstractControl" class="code-anchor">AbstractControl</a></code> 的更新策略（表示控件用来更新自身状态的事件）。 可能的值有 <code>'change'</code> | <code>'blur'</code> | <code>'submit'</code>，默认值是 <code>'change'</code>。</p><p translation-origin="off">Reports the update strategy of the <code><a href="api/forms/AbstractControl" class="code-anchor">AbstractControl</a></code> (meaning the event on which the control updates itself). Possible values: <code>'change'</code> | <code>'blur'</code> | <code>'submit'</code> Default value: <code>'change'</code></p></td></tr><tr class="instance-property"><td><a id="root"></a> <code class=""><span class="member-name">root</span>: <a href="api/forms/AbstractControl" class="code-anchor">AbstractControl</a></code></td><td><span class="read-only-property">只读</span><p translation-result="on">获取该控件的顶级祖先。</p><p translation-origin="off">Retrieves the top-level ancestor of this control.</p></td></tr></tbody></table></section><section class="instance-methods"><a name="methods"></a><h2 id="方法">方法<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#方法"><i class="material-icons">link</i></a></h2><a id="setValidators"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="setvalidators">setValidators() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#setvalidators"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L441-L454" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L441-L454" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">设置该控件上所激活的同步验证器。调用它将会覆盖所有现存的同步验证器。</p><p translation-origin="off">Sets the synchronous validators that are active on this control. Calling this overwrites any existing sync validators.</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">setValidators</span>(newValidator: <a href="api/forms/ValidatorFn" class="code-anchor">ValidatorFn</a> | <a href="api/forms/ValidatorFn" class="code-anchor">ValidatorFn</a>[]): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">setValidators</span></span><span class="pun">(</span><span class="pln">newValidator</span><span class="pun">:</span><span class="pln"> </span><a href="api/forms/ValidatorFn" class="code-anchor"><span class="typ">ValidatorFn</span></a><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><a href="api/forms/ValidatorFn" class="code-anchor"><span class="typ">ValidatorFn</span></a><span class="pun">[]):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-1">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>newValidator</code> </td><td class="param-type"><code><a href="api/forms/ValidatorFn" class="code-anchor">ValidatorFn</a> | <a href="api/forms/ValidatorFn" class="code-anchor">ValidatorFn</a>[]</code></td><td class="param-description"></td></tr></tbody></table><h6 class="no-anchor" id="返回值">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p>When you add or remove a validator at run time, you must call <code><a href="api/forms/AbstractControl#updateValueAndValidity" class="code-anchor">updateValueAndValidity()</a></code> for the new validation to take effect.</p></td></tr></tbody></table><a id="setAsyncValidators"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="setasyncvalidators">setAsyncValidators() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#setasyncvalidators"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L455-L468" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L455-L468" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">设置该控件上所激活的异步验证器。调用它就会覆盖所有现存的异步验证器。</p><p translation-origin="off">Sets the async validators that are active on this control. Calling this overwrites any existing async validators.</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">setAsyncValidators</span>(newValidator: <a href="api/forms/AsyncValidatorFn" class="code-anchor">AsyncValidatorFn</a> | <a href="api/forms/AsyncValidatorFn" class="code-anchor">AsyncValidatorFn</a>[]): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">setAsyncValidators</span></span><span class="pun">(</span><span class="pln">newValidator</span><span class="pun">:</span><span class="pln"> </span><a href="api/forms/AsyncValidatorFn" class="code-anchor"><span class="typ">AsyncValidatorFn</span></a><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><a href="api/forms/AsyncValidatorFn" class="code-anchor"><span class="typ">AsyncValidatorFn</span></a><span class="pun">[]):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-2">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>newValidator</code> </td><td class="param-type"><code><a href="api/forms/AsyncValidatorFn" class="code-anchor">AsyncValidatorFn</a> | <a href="api/forms/AsyncValidatorFn" class="code-anchor">AsyncValidatorFn</a>[]</code></td><td class="param-description"></td></tr></tbody></table><h6 class="no-anchor" id="返回值-1">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p>When you add or remove a validator at run time, you must call <code><a href="api/forms/AbstractControl#updateValueAndValidity" class="code-anchor">updateValueAndValidity()</a></code> for the new validation to take effect.</p></td></tr></tbody></table><a id="clearValidators"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="clearvalidators">clearValidators() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#clearvalidators"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L469-L479" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L469-L479" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">清空同步验证器列表。</p><p translation-origin="off">Empties out the sync validator list.</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">clearValidators</span>(): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">clearValidators</span></span><span class="pun">():</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-3">参数</h6><p>没有参数。</p><h6 class="no-anchor" id="返回值-2">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p>When you add or remove a validator at run time, you must call <code><a href="api/forms/AbstractControl#updateValueAndValidity" class="code-anchor">updateValueAndValidity()</a></code> for the new validation to take effect.</p></td></tr></tbody></table><a id="clearAsyncValidators"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="clearasyncvalidators">clearAsyncValidators() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#clearasyncvalidators"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L480-L490" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L480-L490" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">清空异步验证器列表。</p><p translation-origin="off">Empties out the async validator list.</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">clearAsyncValidators</span>(): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">clearAsyncValidators</span></span><span class="pun">():</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-4">参数</h6><p>没有参数。</p><h6 class="no-anchor" id="返回值-3">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p>When you add or remove a validator at run time, you must call <code><a href="api/forms/AbstractControl#updateValueAndValidity" class="code-anchor">updateValueAndValidity()</a></code> for the new validation to take effect.</p></td></tr></tbody></table><a id="markAsTouched"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="markastouched">markAsTouched() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#markastouched"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L491-L518" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L491-L518" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p>Marks the control as <code>touched</code>. A control is touched by focus and blur events that do not change the value.</p><p>See also:</p><ul><li><p><code><a href="api/forms/AbstractControl#markAsUntouched" class="code-anchor">markAsUntouched()</a></code></p></li><li><p><code><a href="api/forms/AbstractControl#markAsDirty" class="code-anchor">markAsDirty()</a></code></p></li><li><p translation-result="on">把该控件标记为 <code>touched</code>。控件获得焦点并失去焦点不会修改这个值。与 <code>markAsDirty</code> 相对。</p><p translation-origin="off"><code><a href="api/forms/AbstractControl#markAsPristine" class="code-anchor">markAsPristine()</a></code></p></li></ul></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">markAsTouched</span>(opts: { onlySelf?: boolean; } = {}): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">markAsTouched</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-5">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>opts</code> </td><td class="param-type"><code>object</code></td><td class="param-description"><p translation-result="on">在应用完此标记后，该配置项会决定控件如何传播变更及发出事件。</p><p translation-origin="off">Configuration options that determine how the control propagates changes and emits events after marking is applied.</p><ul><li><p translation-result="on"> <code>onlySelf</code>：如果为 <code>true</code> 则只标记当前控件。如果为 <code>false</code> 或不提供，则标记它所有的直系祖先。默认为 <code>false</code>。</p><p translation-origin="off"><code>onlySelf</code>: When true, mark only this control. When false or not supplied, marks all direct ancestors. Default is false.</p></li></ul><p>可选. 默认值是 <code>{}</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-4">返回值</h6><p><code>void</code></p></div></td></tr></tbody></table><a id="markAllAsTouched"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="markallastouched">markAllAsTouched() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#markallastouched"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L519-L528" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L519-L528" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p>Marks the control and all its descendant controls as <code>touched</code>.</p><p>See also:</p><ul><li><p><code><a href="api/forms/AbstractControl#markAsTouched" class="code-anchor">markAsTouched()</a></code></p></li></ul></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">markAllAsTouched</span>(): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">markAllAsTouched</span></span><span class="pun">():</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-6">参数</h6><p>没有参数。</p><h6 class="no-anchor" id="返回值-5">返回值</h6><p><code>void</code></p></div></td></tr></tbody></table><a id="markAsUntouched"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="markasuntouched">markAsUntouched() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#markasuntouched"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L529-L565" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L529-L565" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">把该控件标记为 <code>untouched</code>。</p><p translation-origin="off">Marks the control as <code>untouched</code>.</p><p>See also:</p><ul><li><p><code><a href="api/forms/AbstractControl#markAsTouched" class="code-anchor">markAsTouched()</a></code></p></li><li><p><code><a href="api/forms/AbstractControl#markAsDirty" class="code-anchor">markAsDirty()</a></code></p></li><li><p><code><a href="api/forms/AbstractControl#markAsPristine" class="code-anchor">markAsPristine()</a></code></p></li></ul></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">markAsUntouched</span>(opts: { onlySelf?: boolean; } = {}): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">markAsUntouched</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-7">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>opts</code> </td><td class="param-type"><code>object</code></td><td class="param-description"><p translation-result="on">在应用完此标记后，该配置项会决定控件如何传播变更及发出事件。</p><p translation-origin="off">Configuration options that determine how the control propagates changes and emits events after the marking is applied.</p><ul><li><p translation-result="on"> <code>onlySelf</code>：如果为 <code>true</code> 则只标记当前控件。如果为 <code>false</code> 或不提供，则标记它所有的直系祖先。默认为 <code>false</code>。</p><p translation-origin="off"><code>onlySelf</code>: When true, mark only this control. When false or not supplied, marks all direct ancestors. Default is false.</p></li></ul><p>可选. 默认值是 <code>{}</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-6">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p translation-result="on">如果该控件有任何子控件，还会把所有子控件标记为 <code>untouched</code>，并重新计算所有父控件的 <code>touched</code> 状态。</p><p translation-origin="off">If the control has any children, also marks all children as <code>untouched</code> and recalculates the <code>touched</code> status of all parent controls.</p></td></tr></tbody></table><a id="markAsDirty"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="markasdirty">markAsDirty() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#markasdirty"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L566-L594" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L566-L594" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">把控件标记为 <code>dirty</code>。当控件通过 UI 修改过时控件会变成 <code>dirty</code> 的；与 <code>markAsTouched</code> 相对。</p><p translation-origin="off">Marks the control as <code>dirty</code>. A control becomes dirty when the control's value is changed through the UI; compare <code>markAsTouched</code>.</p><p>See also:</p><ul><li><p><code><a href="api/forms/AbstractControl#markAsTouched" class="code-anchor">markAsTouched()</a></code></p></li><li><p><code><a href="api/forms/AbstractControl#markAsUntouched" class="code-anchor">markAsUntouched()</a></code></p></li><li><p><code><a href="api/forms/AbstractControl#markAsPristine" class="code-anchor">markAsPristine()</a></code></p></li></ul></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">markAsDirty</span>(opts: { onlySelf?: boolean; } = {}): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">markAsDirty</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-8">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>opts</code> </td><td class="param-type"><code>object</code></td><td class="param-description"><p translation-result="on">在应用完此标记后，该配置项会决定控件如何传播变更以及发出事件。</p><p translation-origin="off">Configuration options that determine how the control propagates changes and emits events after marking is applied.</p><ul><li><p translation-result="on"> <code>onlySelf</code>：如果为 <code>true</code> 则只标记当前控件。如果为 <code>false</code> 或不提供，则标记它所有的直系祖先。默认为 <code>false</code>。</p><p translation-origin="off"><code>onlySelf</code>: When true, mark only this control. When false or not supplied, marks all direct ancestors. Default is false.</p></li></ul><p>可选. 默认值是 <code>{}</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-7">返回值</h6><p><code>void</code></p></div></td></tr></tbody></table><a id="markAsPristine"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="markaspristine">markAsPristine() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#markaspristine"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L595-L631" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L595-L631" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">把该控件标记为 <code>pristine</code>（原始状态）。</p><p translation-origin="off">Marks the control as <code>pristine</code>.</p><p>See also:</p><ul><li><p><code><a href="api/forms/AbstractControl#markAsTouched" class="code-anchor">markAsTouched()</a></code></p></li><li><p><code><a href="api/forms/AbstractControl#markAsUntouched" class="code-anchor">markAsUntouched()</a></code></p></li><li><p><code><a href="api/forms/AbstractControl#markAsDirty" class="code-anchor">markAsDirty()</a></code></p></li></ul></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">markAsPristine</span>(opts: { onlySelf?: boolean; } = {}): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">markAsPristine</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-9">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>opts</code> </td><td class="param-type"><code>object</code></td><td class="param-description"><p translation-result="on">在应用完此标记后，该配置项会决定控件如何传播更改以及发出事件。</p><p translation-origin="off">Configuration options that determine how the control emits events after marking is applied.</p><ul><li><p translation-result="on"> <code>onlySelf</code>：如果为 <code>true</code> 则只标记当前控件。如果为 <code>false</code> 或不提供，则标记它所有的直系祖先。默认为 <code>false</code>。</p><p translation-origin="off"><code>onlySelf</code>: When true, mark only this control. When false or not supplied, marks all direct ancestors. Default is false..</p></li></ul><p>可选. 默认值是 <code>{}</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-8">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p translation-result="on">如果该控件有任何子控件，则把所有子控件标记为 <code>pristine</code>，并重新计算所有父控件的 <code>pristine</code> 状态。</p><p translation-origin="off">If the control has any children, marks all children as <code>pristine</code>, and recalculates the <code>pristine</code> status of all parent controls.</p></td></tr></tbody></table><a id="markAsPending"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="markaspending">markAsPending() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#markaspending"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L632-L672" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L632-L672" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">把该控件标记为 <code>pending</code>（待定）的。</p><p translation-origin="off">Marks the control as <code>pending</code>.</p><p>See also:</p><ul><li><a href="api/forms/AbstractControl#status"><code>status</code></a></li></ul></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">markAsPending</span>(opts: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">markAsPending</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> emitEvent</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-10">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>opts</code> </td><td class="param-type"><code>object</code></td><td class="param-description"><p translation-result="on">在应用完此标记后，该配置项会决定控件如何传播变更以及发出事件。</p><p translation-origin="off">Configuration options that determine how the control propagates changes and emits events after marking is applied.</p><ul><li><p translation-result="on"> <code>onlySelf</code>：如果为 <code>true</code> 则只标记当前控件。如果为 <code>false</code> 或不提供，则标记它所有的直系祖先。默认为 <code>false</code>。</p><p translation-origin="off"><code>onlySelf</code>: When true, mark only this control. When false or not supplied, marks all direct ancestors. Default is false..</p></li><li><p translation-result="on"> <code>emitEvent</code>：如果为 <code>true</code> 或未提供（默认值），则 <code>statusChanges</code>（Observable）会发出一个事件，传入控件的最近状态，并把控件标记为 <code>pending</code> 状态。 如果为 <code>false</code>，则不会发出事件。</p><p translation-origin="off"><code>emitEvent</code>: When true or not supplied (the default), the <code>statusChanges</code> observable emits an event with the latest status the control is marked pending. When false, no events are emitted.</p></li></ul><p>可选. 默认值是 <code>{}</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-9">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p translation-result="on">当控件正在执行异步验证时，该控件是 <code>pending</code> 的。</p><p translation-origin="off">A control is pending while the control performs async validation.</p></td></tr></tbody></table><a id="disable"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="disable">disable() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#disable"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L673-L723" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L673-L723" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">禁用此控件。这意味着该控件在表单验证检查时会被豁免，并且从其父控件的聚合值中排除它的值。它的状态是 <code>DISABLED</code>。</p><p translation-origin="off">Disables the control. This means the control is exempt from validation checks and excluded from the aggregate value of any parent. Its status is <code>DISABLED</code>.</p><p>See also:</p><ul><li><a href="api/forms/AbstractControl#status"><code>status</code></a></li></ul></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">disable</span>(opts: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">disable</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> emitEvent</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-11">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>opts</code> </td><td class="param-type"><code>object</code></td><td class="param-description"><p translation-result="on">在该控件被禁用之后，该配置项决定如何传播更改以及发出事件。</p><p translation-origin="off">Configuration options that determine how the control propagates changes and emits events after the control is disabled.</p><ul><li><p translation-result="on"> <code>onlySelf</code>：如果为 <code>true</code>，则只标记当前控件。如果为 <code>false</code> 或没有提供，则标记所有直系祖先。默认为 <code>false</code>。</p><p translation-origin="off"><code>onlySelf</code>: When true, mark only this control. When false or not supplied, marks all direct ancestors. Default is false..</p></li><li><p translation-result="on"> <code>emitEvent</code>：如果为 <code>true</code> 或没有提供（默认），则当控件被禁用时，<code>statusChanges</code> 和 <code>valueChanges</code> 这两个 Observable 都会发出最近的状态和值。 如果为 <code>false</code>，则不会发出事件。</p><p translation-origin="off"><code>emitEvent</code>: When true or not supplied (the default), both the <code>statusChanges</code> and <code>valueChanges</code> observables emit events with the latest status and value when the control is disabled. When false, no events are emitted.</p></li></ul><p>可选. 默认值是 <code>{}</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-10">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p translation-result="on">如果该控件有子控件，则所有子控件也会被禁用。</p><p translation-origin="off">If the control has children, all children are also disabled.</p></td></tr></tbody></table><a id="enable"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="enable">enable() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#enable"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L724-L768" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L724-L768" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">启用该控件。这意味着该控件包含在有效性检查中，并会出现在其父控件的聚合值中。它的状态会根据它的值和验证器而重新计算。</p><p translation-origin="off">Enables the control. This means the control is included in validation checks and the aggregate value of its parent. Its status recalculates based on its value and its validators.</p><p>See also:</p><ul><li><a href="api/forms/AbstractControl#status"><code>status</code></a></li></ul></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">enable</span>(opts: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">enable</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> emitEvent</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-12">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>opts</code> </td><td class="param-type"><code>object</code></td><td class="param-description"><p translation-result="on">当标记为 <code>untouched</code> 时，该配置项会决定该控件如何传播变更以及发出事件。</p><p translation-origin="off">Configure options that control how the control propagates changes and emits events when marked as untouched</p><ul><li><p translation-result="on"> <code>onlySelf</code>：如果为 <code>true</code>，则只标记当前控件。如果为 <code>false</code> 或没有提供，则标记所有直系祖先。默认为 <code>false</code>。</p><p translation-origin="off"><code>onlySelf</code>: When true, mark only this control. When false or not supplied, marks all direct ancestors. Default is false..</p></li><li><p translation-result="on"> <code>emitEvent</code>：如果为 <code>true</code> 或没有提供（默认），则当控件被启用时，<code>statusChanges</code> 和 <code>valueChanges</code> 这两个 Observable 都会发出最近的状态和值。 如果为 <code>false</code>，则不会发出事件。</p><p translation-origin="off"><code>emitEvent</code>: When true or not supplied (the default), both the <code>statusChanges</code> and <code>valueChanges</code> observables emit events with the latest status and value when the control is enabled. When false, no events are emitted.</p></li></ul><p>可选. 默认值是 <code>{}</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-11">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p translation-result="on">默认情况下，如果该控件具有子控件，则所有子控件都会被启用。</p><p translation-origin="off">By default, if the control has children, all children are enabled.</p></td></tr></tbody></table><a id="setParent"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="setparent">setParent() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#setparent"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L780-L786" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L780-L786" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">setParent</span>(parent: <a href="api/forms/FormGroup" class="code-anchor">FormGroup</a> | <a href="api/forms/FormArray" class="code-anchor">FormArray</a>): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">setParent</span></span><span class="pun">(</span><span class="pln">parent</span><span class="pun">:</span><span class="pln"> </span><a href="api/forms/FormGroup" class="code-anchor"><span class="typ">FormGroup</span></a><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><a href="api/forms/FormArray" class="code-anchor"><span class="typ">FormArray</span></a><span class="pun">):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-13">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>parent</code> </td><td class="param-type"><code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a> | <a href="api/forms/FormArray" class="code-anchor">FormArray</a></code></td><td class="param-description"><p translation-result="on">设置该控件的父控件</p><p translation-origin="off">Sets the parent of the control</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-12">返回值</h6><p><code>void</code></p></div></td></tr></tbody></table><a id="setValue"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="setvalue">setValue() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#setvalue"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L787-L793" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L787-L793" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">设置该控件的值。这是一个抽象方法（由子类实现）。</p><p translation-origin="off">Sets the value of the control. Abstract method (implemented in sub-classes).</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none">abstract <span class="member-name">setValue</span>(value: any, options?: Object): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="kwd">abstract</span><span class="pln"> </span><span class="member-name"><span class="pln">setValue</span></span><span class="pun">(</span><span class="pln">value</span><span class="pun">:</span><span class="pln"> any</span><span class="pun">,</span><span class="pln"> options</span><span class="pun">?:</span><span class="pln"> </span><span class="typ">Object</span><span class="pun">):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-14">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>value</code> </td><td class="param-type"><code>any</code></td><td class="param-description"></td></tr><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>options</code> </td><td class="param-type"><code>Object</code></td><td class="param-description"><p>可选. 默认值是 <code>undefined</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-13">返回值</h6><p><code>void</code></p></div></td></tr></tbody></table><a id="patchValue"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="patchvalue">patchValue() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#patchvalue"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L794-L800" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L794-L800" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">修补（patch）该控件的值。这是一个抽象方法（由子类实现）。</p><p translation-origin="off">Patches the value of the control. Abstract method (implemented in sub-classes).</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none">abstract <span class="member-name">patchValue</span>(value: any, options?: Object): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="kwd">abstract</span><span class="pln"> </span><span class="member-name"><span class="pln">patchValue</span></span><span class="pun">(</span><span class="pln">value</span><span class="pun">:</span><span class="pln"> any</span><span class="pun">,</span><span class="pln"> options</span><span class="pun">?:</span><span class="pln"> </span><span class="typ">Object</span><span class="pun">):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-15">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>value</code> </td><td class="param-type"><code>any</code></td><td class="param-description"></td></tr><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>options</code> </td><td class="param-type"><code>Object</code></td><td class="param-description"><p>可选. 默认值是 <code>undefined</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-14">返回值</h6><p><code>void</code></p></div></td></tr></tbody></table><a id="reset"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="reset">reset() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#reset"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L801-L807" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L801-L807" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">重置控件。这是一个抽象方法（由子类实现）。</p><p translation-origin="off">Resets the control. Abstract method (implemented in sub-classes).</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none">abstract <span class="member-name">reset</span>(value?: any, options?: Object): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="kwd">abstract</span><span class="pln"> </span><span class="member-name"><span class="pln">reset</span></span><span class="pun">(</span><span class="pln">value</span><span class="pun">?:</span><span class="pln"> any</span><span class="pun">,</span><span class="pln"> options</span><span class="pun">?:</span><span class="pln"> </span><span class="typ">Object</span><span class="pun">):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-16">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>value</code> </td><td class="param-type"><code>any</code></td><td class="param-description"><p>可选. 默认值是 <code>undefined</code>.</p></td></tr><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>options</code> </td><td class="param-type"><code>Object</code></td><td class="param-description"><p>可选. 默认值是 <code>undefined</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-15">返回值</h6><p><code>void</code></p></div></td></tr></tbody></table><a id="updateValueAndValidity"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="updatevalueandvalidity">updateValueAndValidity() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#updatevalueandvalidity"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L808-L859" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L808-L859" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">重新计算控件的值和校验状态。</p><p translation-origin="off">Recalculates the value and validation status of the control.</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">updateValueAndValidity</span>(opts: { onlySelf?: boolean; emitEvent?: boolean; } = {}): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">updateValueAndValidity</span></span><span class="pun">(</span><span class="pln">opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> onlySelf</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> emitEvent</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-17">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>opts</code> </td><td class="param-type"><code>object</code></td><td class="param-description"><p translation-result="on">当更新和进行有效性检查之后，该配置项会决定控件如何传播变更并发出事件。</p><p translation-origin="off">Configuration options determine how the control propagates changes and emits events after updates and validity checks are applied.</p><ul><li><p translation-result="on"> <code>onlySelf</code>：如果为 <code>true</code>，则只标记当前控件。如果为 <code>false</code> 或没有提供，则标记所有直系祖先。默认为 <code>false</code>。</p><p translation-origin="off"><code>onlySelf</code>: When true, only update this control. When false or not supplied, update all direct ancestors. Default is false..</p></li><li><p translation-result="on"> <code>emitEvent</code>：如果为 <code>true</code> 或没有提供（默认），则当控件被启用时，<code>statusChanges</code> 和 <code>valueChanges</code> 这两个 Observable 都会发出最近的状态和值。 如果为 <code>false</code>，则不会发出事件。</p><p translation-origin="off"><code>emitEvent</code>: When true or not supplied (the default), both the <code>statusChanges</code> and <code>valueChanges</code> observables emit events with the latest status and value when the control is updated. When false, no events are emitted.</p></li></ul><p>可选. 默认值是 <code>{}</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-16">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p translation-result="on">默认情况下，它还会更新其直系祖先的值和有效性状态。</p><p translation-origin="off">By default, it also updates the value and validity of its ancestors.</p></td></tr></tbody></table><a id="setErrors"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="seterrors">setErrors() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#seterrors"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L889-L922" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L889-L922" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">在手动（而不是自动）运行校验之后，设置表单控件上的错误信息。</p><p translation-origin="off">Sets errors on a form control when running validations manually, rather than automatically.</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">setErrors</span>(errors: <a href="api/forms/ValidationErrors" class="code-anchor">ValidationErrors</a>, opts: { emitEvent?: boolean; } = {}): void</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">setErrors</span></span><span class="pun">(</span><span class="pln">errors</span><span class="pun">:</span><span class="pln"> </span><a href="api/forms/ValidationErrors" class="code-anchor"><span class="typ">ValidationErrors</span></a><span class="pun">,</span><span class="pln"> opts</span><span class="pun">:</span><span class="pln"> </span><span class="pun">{</span><span class="pln"> emitEvent</span><span class="pun">?:</span><span class="pln"> boolean</span><span class="pun">;</span><span class="pln"> </span><span class="pun">}</span><span class="pln"> </span><span class="pun">=</span><span class="pln"> </span><span class="pun">{}):</span><span class="pln"> </span><span class="kwd">void</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-18">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>errors</code> </td><td class="param-type"><code><a href="api/forms/ValidationErrors" class="code-anchor">ValidationErrors</a></code></td><td class="param-description"></td></tr><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>opts</code> </td><td class="param-type"><code>object</code></td><td class="param-description"><p>可选. 默认值是 <code>{}</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-17">返回值</h6><p><code>void</code></p></div></td></tr><tr><td class="description"><p translation-result="on">调用 <code>setErrors</code> 还会更新父控件的有效性状态。</p><p translation-origin="off">Calling <code>setErrors</code> also updates the validity of the parent control.</p></td></tr><tr><td class="usage-notes"><h4 id="setErrors-usage-notes">使用说明<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#setErrors-usage-notes"><i class="material-icons">link</i></a></h4><h5 id="manually-set-the-errors-for-a-control" translation-result="on">手动设置控件上的错误信息。<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#manually-set-the-errors-for-a-control"><i class="material-icons">link</i></a></h5><h5 translation-origin="off" id="manually-set-the-errors-for-a-control">Manually set the errors for a control<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#manually-set-the-errors-for-a-control"><i class="material-icons">link</i></a></h5><code-example ng-version="9.0.0-rc.11"><div style="display:none">const login = new <a href="api/forms/FormControl" class="code-anchor">FormControl</a>('someLogin'); login.setErrors({ notUnique: true }); expect(login.valid).toEqual(false); expect(login.errors).toEqual({ notUnique: true }); login.setValue('someOtherLogin'); expect(login.valid).toEqual(true);</div><aio-code><pre class="lang- prettyprint">      <button title="Copy code snippet" class="material-icons copy-button no-print ng-star-inserted" aria-label="">
        <span aria-hidden="true">content_copy</span>
      </button>
      <code class="animated fadeIn"><span class="kwd">const</span><span class="pln"> login </span><span class="pun">=</span><span class="pln"> </span><span class="kwd">new</span><span class="pln"> </span><a href="api/forms/FormControl" class="code-anchor"><span class="typ">FormControl</span></a><span class="pun">(</span><span class="str">'someLogin'</span><span class="pun">);</span><span class="pln">
login</span><span class="pun">.</span><span class="pln">setErrors</span><span class="pun">({</span><span class="pln">
  notUnique</span><span class="pun">:</span><span class="pln"> </span><span class="kwd">true</span><span class="pln">
</span><span class="pun">});</span><span class="pln">

expect</span><span class="pun">(</span><span class="pln">login</span><span class="pun">.</span><span class="pln">valid</span><span class="pun">).</span><span class="pln">toEqual</span><span class="pun">(</span><span class="kwd">false</span><span class="pun">);</span><span class="pln">
expect</span><span class="pun">(</span><span class="pln">login</span><span class="pun">.</span><span class="pln">errors</span><span class="pun">).</span><span class="pln">toEqual</span><span class="pun">({</span><span class="pln"> notUnique</span><span class="pun">:</span><span class="pln"> </span><span class="kwd">true</span><span class="pln"> </span><span class="pun">});</span><span class="pln">

login</span><span class="pun">.</span><span class="pln">setValue</span><span class="pun">(</span><span class="str">'someOtherLogin'</span><span class="pun">);</span><span class="pln">

expect</span><span class="pun">(</span><span class="pln">login</span><span class="pun">.</span><span class="pln">valid</span><span class="pun">).</span><span class="pln">toEqual</span><span class="pun">(</span><span class="kwd">true</span><span class="pun">);</span></code>
    </pre></aio-code></code-example></td></tr></tbody></table><a id="get"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="get">get() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#get"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L923-L952" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L923-L952" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">根据指定的控件名称或路径获取子控件。</p><p translation-origin="off">Retrieves a child control given the control's name or path.</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">get</span>(path: string | (string | <a href="api/common/DecimalPipe" class="code-anchor">number</a>)[]): <a href="api/forms/AbstractControl" class="code-anchor">AbstractControl</a> | null</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="kwd">get</span></span><span class="pun">(</span><span class="pln">path</span><span class="pun">:</span><span class="pln"> string </span><span class="pun">|</span><span class="pln"> </span><span class="pun">(</span><span class="pln">string </span><span class="pun">|</span><span class="pln"> </span><a href="api/common/DecimalPipe" class="code-anchor"><span class="pln">number</span></a><span class="pun">)[]):</span><span class="pln"> </span><a href="api/forms/AbstractControl" class="code-anchor"><span class="typ">AbstractControl</span></a><span class="pln"> </span><span class="pun">|</span><span class="pln"> </span><span class="kwd">null</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-19">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>path</code> </td><td class="param-type"><code>string | (string | <a href="api/common/DecimalPipe" class="code-anchor">number</a>)[]</code></td><td class="param-description"><p translation-result="on">一个由点号（<code>.</code>）分隔的字符串或 "字符串/数字" 数组定义的控件路径。</p><p translation-origin="off">A dot-delimited string or array of string/number values that define the path to the control.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-18">返回值</h6><p><code><a href="api/forms/AbstractControl" class="code-anchor">AbstractControl</a> | null</code></p></div></td></tr><tr><td class="usage-notes"><h4 id="get-usage-notes">使用说明<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#get-usage-notes"><i class="material-icons">link</i></a></h4><h5 id="retrieve-a-nested-control" translation-result="on">获取嵌套的控件<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#retrieve-a-nested-control"><i class="material-icons">link</i></a></h5><h5 translation-origin="off" id="retrieve-a-nested-control">Retrieve a nested control<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#retrieve-a-nested-control"><i class="material-icons">link</i></a></h5><p translation-result="on">比如，要获取子控件组 <code>person</code> 中的 <code>name</code> 控件：</p><p translation-origin="off">For example, to get a <code>name</code> control nested within a <code>person</code> sub-group:</p><ul><li><code>this.form.get('person.name');</code></li></ul><p>-OR-</p><ul><li>或 -</li></ul><ul><li><code>this.form.get(['person', 'name']);</code></li></ul></td></tr></tbody></table><a id="getError"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="geterror">getError() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#geterror"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L953-L1005" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L953-L1005" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">报告具有指定路径的控件的错误数据。</p><p translation-origin="off">Reports error data for the control with the given path.</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">getError</span>(errorCode: string, path?: string | (string | <a href="api/common/DecimalPipe" class="code-anchor">number</a>)[]): any</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">getError</span></span><span class="pun">(</span><span class="pln">errorCode</span><span class="pun">:</span><span class="pln"> string</span><span class="pun">,</span><span class="pln"> path</span><span class="pun">?:</span><span class="pln"> string </span><span class="pun">|</span><span class="pln"> </span><span class="pun">(</span><span class="pln">string </span><span class="pun">|</span><span class="pln"> </span><a href="api/common/DecimalPipe" class="code-anchor"><span class="pln">number</span></a><span class="pun">)[]):</span><span class="pln"> any</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-20">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>errorCode</code> </td><td class="param-type"><code>string</code></td><td class="param-description"><p translation-result="on">所查出的错误的错误码</p><p translation-origin="off">The code of the error to check</p></td></tr><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>path</code> </td><td class="param-type"><code>string | (string | <a href="api/common/DecimalPipe" class="code-anchor">number</a>)[]</code></td><td class="param-description"><p translation-result="on">一个控件名列表，用于指定要如何从当前控件移动到要查询错误的那个控件。</p><p translation-origin="off">A list of control names that designates how to move from the current control to the control that should be queried for errors.</p><p>可选. 默认值是 <code>undefined</code>.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-19">返回值</h6><p translation-result="on">特定错误的数据，如果该控件不存在或没有错误，则返回 null。</p><p translation-origin="off"><code>any</code>: error data for that particular error. If the control or error is not present, null is returned.</p></div></td></tr><tr><td class="usage-notes"><h4 id="getError-usage-notes">使用说明<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#getError-usage-notes"><i class="material-icons">link</i></a></h4><p translation-result="on">比如，对于下列 <code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a></code>：</p><p translation-origin="off">For example, for the following <code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a></code>:</p><code-example ng-version="9.0.0-rc.11"><div style="display:none">form = new <a href="api/forms/FormGroup" class="code-anchor">FormGroup</a>({ address: new <a href="api/forms/FormGroup" class="code-anchor">FormGroup</a>({ street: new <a href="api/forms/FormControl" class="code-anchor">FormControl</a>() }) });</div><aio-code><pre class="lang- prettyprint">      <button title="Copy code snippet" class="material-icons copy-button no-print ng-star-inserted" aria-label="">
        <span aria-hidden="true">content_copy</span>
      </button>
      <code class="animated fadeIn"><span class="pln">form </span><span class="pun">=</span><span class="pln"> </span><span class="kwd">new</span><span class="pln"> </span><a href="api/forms/FormGroup" class="code-anchor"><span class="typ">FormGroup</span></a><span class="pun">({</span><span class="pln">
  address</span><span class="pun">:</span><span class="pln"> </span><span class="kwd">new</span><span class="pln"> </span><a href="api/forms/FormGroup" class="code-anchor"><span class="typ">FormGroup</span></a><span class="pun">({</span><span class="pln"> street</span><span class="pun">:</span><span class="pln"> </span><span class="kwd">new</span><span class="pln"> </span><a href="api/forms/FormControl" class="code-anchor"><span class="typ">FormControl</span></a><span class="pun">()</span><span class="pln"> </span><span class="pun">})</span><span class="pln">
</span><span class="pun">});</span></code>
    </pre></aio-code></code-example><p translation-result="on">从根表单移动到这个 'street' 控件的路径应该是 'address' -&gt; 'street'。</p><p translation-origin="off">The path to the 'street' control from the root form would be 'address' -&gt; 'street'.</p><p translation-result="on">可以用两种格式把它提供给此方法：</p><p translation-origin="off">It can be provided to this method in one of two formats:</p><ol><li><p translation-result="on">一个表示控件名的字符串数组，比如 <code>['address', 'street']</code></p><p translation-origin="off">An array of string control names, e.g. <code>['address', 'street']</code></p></li><li><p translation-result="on">一个点号分隔的控件名列表构成的单一字符串，比如 <code>'address.street'</code></p><p translation-origin="off">A period-delimited list of control names in one string, e.g. <code>'address.street'</code></p></li></ol></td></tr></tbody></table><a id="hasError"></a><table class="is-full-width method-table instance-method"><thead><tr><th><div class="with-github-links"><h3 id="haserror">hasError() <a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#haserror"><i class="material-icons">link</i></a></h3><div class="github-links"><a href="https://github.com/angular/angular-cn/edit/aio/packages/forms/src/model.ts?message=docs(forms)%3A%20请简述你的修改...#L1006-L1049" aria-label="提供编辑建议" title="提供编辑建议"><i class="material-icons" aria-hidden="true" role="img">mode_edit</i></a> <a href="https://github.com/angular/angular-cn/tree/9.0.0/packages/forms/src/model.ts#L1006-L1049" aria-label="查看源码" title="查看源码"><i class="material-icons" aria-hidden="true" role="img">code</i></a></div></div></th></tr></thead><tbody><tr><td class="short-description"><p translation-result="on">报告指定路径下的控件上是否有指定的错误。</p><p translation-origin="off">Reports whether the control with the given path has the error specified.</p></td></tr><tr><td><div class="overload-info"><code-example language="ts" hidecopy="true" class="no-box api-heading" ng-version="9.0.0-rc.11"><div style="display:none"><span class="member-name">hasError</span>(errorCode: string, path?: string | (string | <a href="api/common/DecimalPipe" class="code-anchor">number</a>)[]): boolean</div><aio-code><pre class="lang-ts prettyprint">      
      <code class="animated fadeIn"><span class="member-name"><span class="pln">hasError</span></span><span class="pun">(</span><span class="pln">errorCode</span><span class="pun">:</span><span class="pln"> string</span><span class="pun">,</span><span class="pln"> path</span><span class="pun">?:</span><span class="pln"> string </span><span class="pun">|</span><span class="pln"> </span><span class="pun">(</span><span class="pln">string </span><span class="pun">|</span><span class="pln"> </span><a href="api/common/DecimalPipe" class="code-anchor"><span class="pln">number</span></a><span class="pun">)[]):</span><span class="pln"> boolean</span></code>
    </pre></aio-code></code-example><h6 class="no-anchor" id="参数-21">参数</h6><table class="is-full-width list-table parameters-table instance-method-overload-parameters"><tbody><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>errorCode</code> </td><td class="param-type"><code>string</code></td><td class="param-description"><p translation-result="on">要获取的数据的错误码</p><p translation-origin="off">The code of the error to check</p></td></tr><tr class="instance-method-overload-parameter"><td class="param-name"><a id=""></a> <code>path</code> </td><td class="param-type"><code>string | (string | <a href="api/common/DecimalPipe" class="code-anchor">number</a>)[]</code></td><td class="param-description"><p translation-result="on">可选. 默认值是 <code>undefined</code>.</p><p translation-origin="off">A list of control names that designates how to move from the current control to the control that should be queried for errors.</p></td></tr></tbody></table><h6 class="no-anchor" id="返回值-20">返回值</h6><p><code>boolean</code>: whether the given error is present in the control at the given path.</p><p translation-result="on">如果指定路径下的控件有这个错误则返回 <code>true</code>，否则返回 <code>false</code>。</p><p translation-origin="off">If the control is not present, false is returned.</p></div></td></tr><tr><td class="usage-notes"><h4 id="hasError-usage-notes">使用说明<a title="Link to this heading" class="header-link" aria-hidden="true" href="api/forms/AbstractControl#hasError-usage-notes"><i class="material-icons">link</i></a></h4><p>For example, for the following <code><a href="api/forms/FormGroup" class="code-anchor">FormGroup</a></code>:</p><code-example ng-version="9.0.0-rc.11"><div style="display:none">form = new <a href="api/forms/FormGroup" class="code-anchor">FormGroup</a>({ address: new <a href="api/forms/FormGroup" class="code-anchor">FormGroup</a>({ street: new <a href="api/forms/FormControl" class="code-anchor">FormControl</a>() }) });</div><aio-code><pre class="lang- prettyprint">      <button title="Copy code snippet" class="material-icons copy-button no-print ng-star-inserted" aria-label="">
        <span aria-hidden="true">content_copy</span>
      </button>
      <code class="animated fadeIn"><span class="pln">form </span><span class="pun">=</span><span class="pln"> </span><span class="kwd">new</span><span class="pln"> </span><a href="api/forms/FormGroup" class="code-anchor"><span class="typ">FormGroup</span></a><span class="pun">({</span><span class="pln">
  address</span><span class="pun">:</span><span class="pln"> </span><span class="kwd">new</span><span class="pln"> </span><a href="api/forms/FormGroup" class="code-anchor"><span class="typ">FormGroup</span></a><span class="pun">({</span><span class="pln"> street</span><span class="pun">:</span><span class="pln"> </span><span class="kwd">new</span><span class="pln"> </span><a href="api/forms/FormControl" class="code-anchor"><span class="typ">FormControl</span></a><span class="pun">()</span><span class="pln"> </span><span class="pun">})</span><span class="pln">
</span><span class="pun">});</span></code>
    </pre></aio-code></code-example><p>The path to the 'street' control from the root form would be 'address' -&gt; 'street'.</p><p>It can be provided to this method in one of two formats:</p><ol><li>An array of string control names, e.g. <code>['address', 'street']</code></li><li>A period-delimited list of control names in one string, e.g. <code>'address.street'</code></li></ol><p translation-result="on">要检查的控件的路径。如果没有提供该参数，则检查该控件中的错误。</p><p translation-origin="off">If no path is given, this method checks for the error on the current control.</p></td></tr></tbody></table></section></div></article></div></aio-doc-viewer></main></mat-sidenav-content></mat-sidenav-container><div class="toc-container no-print ng-star-inserted"><aio-lazy-ce selector="aio-toc"><aio-toc ng-version="9.0.0-rc.11"><div class="toc-inner no-print collapsed ng-star-inserted"><ul class="toc-list"><li class="h1 ng-star-inserted active" title="AbstractControl"><a href="api/forms/AbstractControl#abstractcontrol">AbstractControl</a></li><li class="h2 ng-star-inserted" title="子类"><a href="api/forms/AbstractControl#子类">子类</a></li><li class="h2 ng-star-inserted" title="参见"><a href="api/forms/AbstractControl#see-also">参见</a></li><li class="h2 ng-star-inserted" title="说明"><a href="api/forms/AbstractControl#description">说明</a></li><li class="h2 ng-star-inserted" title="构造函数"><a href="api/forms/AbstractControl#constructor">构造函数</a></li><li class="h2 ng-star-inserted" title="属性"><a href="api/forms/AbstractControl#属性">属性</a></li><li class="h2 ng-star-inserted" title="方法"><a href="api/forms/AbstractControl#方法">方法</a></li><li class="h3 ng-star-inserted" title="setValidators()"><a href="api/forms/AbstractControl#setvalidators">setValidators()</a></li><li class="h3 ng-star-inserted" title="setAsyncValidators()"><a href="api/forms/AbstractControl#setasyncvalidators">setAsyncValidators()</a></li><li class="h3 ng-star-inserted" title="clearValidators()"><a href="api/forms/AbstractControl#clearvalidators">clearValidators()</a></li><li class="h3 ng-star-inserted" title="clearAsyncValidators()"><a href="api/forms/AbstractControl#clearasyncvalidators">clearAsyncValidators()</a></li><li class="h3 ng-star-inserted" title="markAsTouched()"><a href="api/forms/AbstractControl#markastouched">markAsTouched()</a></li><li class="h3 ng-star-inserted" title="markAllAsTouched()"><a href="api/forms/AbstractControl#markallastouched">markAllAsTouched()</a></li><li class="h3 ng-star-inserted" title="markAsUntouched()"><a href="api/forms/AbstractControl#markasuntouched">markAsUntouched()</a></li><li class="h3 ng-star-inserted" title="markAsDirty()"><a href="api/forms/AbstractControl#markasdirty">markAsDirty()</a></li><li class="h3 ng-star-inserted" title="markAsPristine()"><a href="api/forms/AbstractControl#markaspristine">markAsPristine()</a></li><li class="h3 ng-star-inserted" title="markAsPending()"><a href="api/forms/AbstractControl#markaspending">markAsPending()</a></li><li class="h3 ng-star-inserted" title="disable()"><a href="api/forms/AbstractControl#disable">disable()</a></li><li class="h3 ng-star-inserted" title="enable()"><a href="api/forms/AbstractControl#enable">enable()</a></li><li class="h3 ng-star-inserted" title="setParent()"><a href="api/forms/AbstractControl#setparent">setParent()</a></li><li class="h3 ng-star-inserted" title="setValue()"><a href="api/forms/AbstractControl#setvalue">setValue()</a></li><li class="h3 ng-star-inserted" title="patchValue()"><a href="api/forms/AbstractControl#patchvalue">patchValue()</a></li><li class="h3 ng-star-inserted" title="reset()"><a href="api/forms/AbstractControl#reset">reset()</a></li><li class="h3 ng-star-inserted" title="updateValueAndValidity()"><a href="api/forms/AbstractControl#updatevalueandvalidity">updateValueAndValidity()</a></li><li class="h3 ng-star-inserted" title="setErrors()"><a href="api/forms/AbstractControl#seterrors">setErrors()</a></li><li class="h3 ng-star-inserted" title="get()"><a href="api/forms/AbstractControl#get">get()</a></li><li class="h3 ng-star-inserted" title="getError()"><a href="api/forms/AbstractControl#geterror">getError()</a></li><li class="h3 ng-star-inserted" title="hasError()"><a href="api/forms/AbstractControl#haserror">hasError()</a></li></ul></div></aio-toc></aio-lazy-ce></div><footer class="no-print"><aio-footer><div class="grid-fluid"><div class="footer-block ng-star-inserted"><h3>资源</h3><ul><li class="ng-star-inserted"><a class="link" href="about" title="Angular 贡献者。">关于</a></li><li class="ng-star-inserted"><a class="link" href="resources" title="网络上的 Angular 工具、培训、博客等">资源列表</a></li><li class="ng-star-inserted"><a class="link" href="presskit" title="我们的联系方式、LOGO 和品牌">宣传资料</a></li><li class="ng-star-inserted"><a class="link" href="https://blog.angular.io/" title="Angular 官方博客">博客</a></li><li class="ng-star-inserted"><a class="link" href="analytics" title="Angular 使用情况分析">使用情况分析</a></li></ul></div><div class="footer-block ng-star-inserted"><h3>帮助</h3><ul><li class="ng-star-inserted"><a class="link" href="https://stackoverflow.com/questions/tagged/angular" title="Stack Overflow: 这里的社区会回答你关于 Angular 的技术问题">Stack Overflow</a></li><li class="ng-star-inserted"><a class="link" href="https://gitter.im/angular/angular" title="和老鸟聊 Angular">Gitter</a></li><li class="ng-star-inserted"><a class="link" href="https://github.com/angular/angular/issues" title="在 github 上报告问题和建议。">报告问题</a></li><li class="ng-star-inserted"><a class="link" href="https://github.com/angular/code-of-conduct/blob/master/CODE_OF_CONDUCT.md" title="让我们彼此尊重">行为规范</a></li></ul></div><div class="footer-block ng-star-inserted"><h3>社区</h3><ul><li class="ng-star-inserted"><a class="link" href="events" title="Angular events around the world.">活动</a></li><li class="ng-star-inserted"><a class="link" href="http://www.meetup.com/topics/angularjs/" title="参加聚会，向别的开发人员学习">聚会</a></li><li class="ng-star-inserted"><a class="link" href="https://twitter.com/angular" title="Twitter">Twitter</a></li><li class="ng-star-inserted"><a class="link" href="https://github.com/angular/angular" title="GitHub">GitHub</a></li><li class="ng-star-inserted"><a class="link" href="contribute" title="向 Angular 做贡献">做贡献</a></li></ul></div><div class="footer-block ng-star-inserted"><h3>多语言</h3><ul><li class="ng-star-inserted"><a class="link" href="https://angular.io/" title="English Version.">English Version</a></li><li class="ng-star-inserted"><a class="link" href="https://angular.tw/" title="正體中文版">正體中文版</a></li><li class="ng-star-inserted"><a class="link" href="https://angular.jp/" title="日本語版">日本語版</a></li><li class="ng-star-inserted"><a class="link" href="https://angular.kr/" title="한국어">한국어</a></li></ul></div></div><p>Super-powered by Google ©2010-2020. 代码授权方式：<a href="license" title="License text">MIT-style License</a>. 文档授权方式：<a href="http://creativecommons.org/licenses/by/4.0/">CC BY 4.0</a>.</p><p>当前版本：9.0.1-build.79+sha.55f1ef01.</p></aio-footer></footer><div class="cdk-visually-hidden ng-star-inserted"><mat-icon role="img" class="mat-icon notranslate material-icons mat-icon-no-color" aria-hidden="true">&nbsp;</mat-icon></div></aio-shell><noscript><div class="background-sky hero"></div><section id="intro" style="text-shadow:1px 1px #1976d2"><div class="hero-logo"><img src="assets/images/logos/angular/angular.svg" width="250" height="250" alt="Angular"></div><div class="homepage-container"><div class="hero-headline">一套框架，多种平台<br>移动 &amp; 桌面</div></div></section><h2 style="color:red;margin-top:40px;position:relative;text-align:center;text-shadow:1px 1px #fafafa"><b><i>该网站需要浏览器支持 JavaScript</i></b></h2></noscript><script src="runtime-es2015.ee607cf78010348c8334.js" type="module"></script><script src="runtime-es5.ee607cf78010348c8334.js" nomodule="" defer=""></script><script src="polyfills-es5.1494ca908613f3429457.js" nomodule="" defer=""></script><script src="polyfills-es2015.9057a05c650bf60ecbf4.js" type="module"></script><script src="main-es2015.9cd62e243bd182514a19.js" type="module"></script><script src="main-es5.9cd62e243bd182514a19.js" nomodule="" defer=""></script><div class="cdk-live-announcer-element cdk-visually-hidden" aria-atomic="true" aria-live="polite"></div></body></html>